zod-compiler 1.27.0 → 2.0.0

package/dist/unplugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/unplugin/index.ts"],"sourcesContent":["import process from \"node:process\";\nimport { createUnplugin, type UnpluginContextMeta } from \"unplugin\";\nimport type { CodegenMode } from \"../core/codegen/context.js\";\nimport { getFirstPartyModulePaths, invalidateModuleCache } from \"../loader.js\";\nimport { collectStaticDeps, resetDepGraphMemo } from \"./dep-graph.js\";\nimport { DiskCache, resetDepValidationMemo } from \"./disk-cache.js\";\nimport {\n  log,\n  shouldTransform,\n  TRANSFORM_ID_FILTER,\n  transformCodeFilter,\n  type TransformSourceMap,\n  transformCodeWithMap,\n} from \"./transform.js\";\nimport type { BuildStats, ZodCompilerPluginOptions } from \"./types.js\";\nimport { BuildStatsAccumulator } from \"./types.js\";\nimport {\n  loadVirtual,\n  RESOLVED_RUNTIME_ID_FILTER,\n  resolveVirtualId,\n  RUNTIME_SPECIFIER_FILTER,\n  VIRTUAL_RUNTIME_ID,\n  WP_RUNTIME_ID,\n} from \"./virtual.js\";\n\n/**\n * Frameworks whose resolveId/load hooks receive any import specifier, including\n * `virtual:` URIs and bare specifiers, so lean-mode cross-file dedup works.\n * webpack / rspack reject the `virtual:` URI scheme but accept bare specifiers,\n * so they use WP_RUNTIME_ID (`__zod-compiler-runtime__`) instead of VIRTUAL_RUNTIME_ID.\n */\nconst VIRTUAL_MODULE_FRAMEWORKS = new Set([\n  \"vite\",\n  \"rollup\",\n  \"rolldown\",\n  \"esbuild\",\n  \"farm\",\n  \"bun\",\n  \"rspack\",\n  \"webpack\",\n]);\n\n/** Frameworks that need the bare-specifier runtime ID instead of `virtual:`. */\nconst WP_FRAMEWORKS = new Set([\"rspack\", \"webpack\"]);\n\n/** File extensions whose changes can affect a schema module graph. */\nconst SOURCE_LIKE = /\\.([cm]?[jt]sx?|json)$/;\n\n/**\n * esbuild has no hook-filter support of its own: unplugin registers a single\n * `onLoad` covering both the load and transform hooks, and its transform shim\n * reads the file off disk before any JS-side filter runs. `onLoadFilter` is\n * the one filter esbuild itself applies (in Go, before calling into JS), so it\n * carries the union of what either hook can handle — source files for\n * transform, the resolved runtime module for load (derived from the load\n * filter so the two cannot drift; a miss there would leave the lean-mode\n * runtime import unresolved). The hooks' own filters narrow it further.\n */\nconst ESBUILD_LOAD_FILTER = new RegExp(`\\\\.[cm]?[jt]sx?$|${RESOLVED_RUNTIME_ID_FILTER.source}`);\n\nexport const unplugin = createUnplugin(\n  (options: ZodCompilerPluginOptions | undefined, meta: UnpluginContextMeta) => {\n    const schemasMode = options?.schemas ?? \"auto\";\n    const autoDiscover = schemasMode === \"auto\";\n    const outputMode = options?.output ?? \"schema\";\n    // \"compact\" keeps the Zod schema (its safeParse IS the cold error path) — so\n    // it is zod-compatible like \"schema\"; only \"bag\" drops the schema object.\n    const zodCompat = outputMode === \"schema\" || outputMode === \"compact\";\n    const compact = outputMode === \"compact\";\n    const stats = new BuildStatsAccumulator();\n    // Transform results keyed by id, validated by content: bundlers re-run\n    // transform for the same file (multiple environments, watch rebuilds) —\n    // identical content returns the cached result, changed content recomputes.\n    const cache = new Map<\n      string,\n      { code: string; result: string | null; map?: TransformSourceMap | null }\n    >();\n    const verbose = options?.verbose === true;\n    const mode: CodegenMode =\n      options?.codegenMode ?? (VIRTUAL_MODULE_FRAMEWORKS.has(meta.framework) ? \"lean\" : \"inline\");\n    const runtimeId = WP_FRAMEWORKS.has(meta.framework) ? WP_RUNTIME_ID : VIRTUAL_RUNTIME_ID;\n    // Persistent transform-result cache: discovery executes schema files (and\n    // their import graphs) in-process, and the in-memory caches die with the\n    // process — without a disk cache every test run / build re-pays that cost.\n    // Entries self-validate against dep content hashes, so watch invalidation\n    // semantics carry across processes.\n    const cacheOption = options?.cache ?? true;\n    const diskCache =\n      cacheOption === false\n        ? null\n        : new DiskCache(\n            DiskCache.resolveDir(cacheOption),\n            JSON.stringify({\n              mode,\n              runtimeId,\n              output: outputMode,\n              schemas: schemasMode,\n              hoist:\n                typeof options?.hoist === \"object\"\n                  ? String(options.hoist.schemaNamePattern ?? \"default\")\n                  : (options?.hoist ?? true),\n            }),\n            getFirstPartyModulePaths,\n          );\n    // Vite only (other bundlers ignore the field): when the plugin runs.\n    // The default compiles production builds AND test runs — tests should\n    // exercise (and benefit from) the validators that ship — while plain dev\n    // servers skip AOT cost and use the Zod fallback. Vitest runs Vite in\n    // serve mode but is detectable via the VITEST env var / \"test\" mode.\n    const viteApply =\n      options?.apply === \"all\"\n        ? undefined\n        : (options?.apply ??\n          ((_config: unknown, env: { command: string; mode: string }) =>\n            env.command === \"build\" || env.mode === \"test\" || process.env[\"VITEST\"] !== undefined));\n\n    // Hook filters (unplugin object hooks): bundlers that support them\n    // natively — Rolldown, Vite, Rollup 4.40+ — reject a module before ever\n    // calling into JS, and unplugin applies the same patterns itself\n    // everywhere else. The `code` filter is the big one: a file that never\n    // mentions zod cannot produce output, so it no longer costs a hook call,\n    // a content hash and an import scan per build.\n    const codeFilter = transformCodeFilter(options);\n    const transformFilter =\n      codeFilter === undefined\n        ? { id: TRANSFORM_ID_FILTER }\n        : { code: codeFilter, id: TRANSFORM_ID_FILTER };\n\n    return {\n      name: \"zod-compiler\",\n      enforce: \"pre\" as const,\n\n      vite: viteApply === undefined ? {} : { apply: viteApply },\n\n      esbuild: { onLoadFilter: ESBUILD_LOAD_FILTER },\n\n      resolveId: {\n        filter: { id: RUNTIME_SPECIFIER_FILTER },\n        handler(id: string) {\n          return resolveVirtualId(id);\n        },\n      },\n\n      load: {\n        filter: { id: RESOLVED_RUNTIME_ID_FILTER },\n        handler(id: string) {\n          return loadVirtual(id);\n        },\n      },\n\n      transform: {\n        filter: transformFilter,\n        async handler(code: string, id: string) {\n          // The filter covers the static half of shouldTransform(); the\n          // include/exclude options — picomatch `contains` semantics, which the\n          // native filters do not reproduce — are applied here, as is the whole\n          // check for hosts that ignore filters.\n          if (!shouldTransform(id, options)) return;\n\n          const cached = cache.get(id);\n          if (cached && cached.code === code) {\n            return cached.result === null\n              ? undefined\n              : { code: cached.result, map: cached.map ?? null };\n          }\n          if (cached) {\n            // Content changed but no watchChange fired (bundlers without the\n            // hook): drop stale module executions before re-discovering.\n            invalidateModuleCache();\n          }\n\n          // Disk cache: skip static-filtering, discovery (file execution!) and\n          // codegen entirely when a previous process already transformed this\n          // exact content and every dep it executed is unchanged.\n          const diskKey = diskCache === null ? null : diskCache.key(id, code);\n          if (diskCache !== null && diskKey !== null) {\n            const entry = diskCache.load(diskKey);\n            if (entry !== null) {\n              cache.set(id, { code, result: entry.result, map: entry.map ?? null });\n              if (entry.stats) {\n                stats.add({\n                  files: 1,\n                  schemas: entry.stats.schemas,\n                  optimized: entry.stats.optimized,\n                  failed: 0,\n                });\n              }\n              if (verbose && entry.result !== null) {\n                log(`Using cached transform for ${id}`);\n              }\n              return entry.result === null\n                ? undefined\n                : { code: entry.result, map: entry.map ?? null };\n            }\n          }\n\n          let discoveryRan = false;\n          let substantialWork = false;\n          let uncacheable = false;\n          let fileStats: BuildStats | null = null;\n          const output = await transformCodeWithMap(code, id, {\n            mode,\n            runtimeId,\n            verbose,\n            zodCompat,\n            compact,\n            autoDiscover,\n            hoist: options?.hoist,\n            onDiscovery() {\n              discoveryRan = true;\n            },\n            onSubstantialWork() {\n              substantialWork = true;\n            },\n            onUncacheableResult() {\n              uncacheable = true;\n            },\n            onBuildStats(s) {\n              stats.add(s);\n              fileStats = s;\n            },\n          });\n          const result = output === null ? null : output.code;\n          const map = output === null ? null : output.map;\n          cache.set(id, { code, result, map });\n\n          // Persist when the transform did real work: produced output, ran\n          // discovery, or did parse-level work (hoist scan / static filter) —\n          // even when that work concluded \"no transform needed\". Null results\n          // used to be skipped on the theory that bail-outs are cheaper than a\n          // cache probe; that holds for textual bail-outs (still never\n          // persisted) but not for the scans: hoist-only mode re-paid a full\n          // scan per zod-importing file per run (35.8s/run in a field report)\n          // purely to re-derive nulls.\n          if (\n            diskCache !== null &&\n            diskKey !== null &&\n            !uncacheable &&\n            (result !== null || discoveryRan || substantialWork)\n          ) {\n            // TS narrows fileStats to null here (assignment happens inside a\n            // callback it cannot track) — widen back.\n            const s = fileStats as BuildStats | null;\n            const entryStats =\n              s === null ? undefined : { schemas: s.schemas, optimized: s.optimized };\n            if (!discoveryRan) {\n              // Discovery-free results (hoist scans, static-filter rejections,\n              // hoist-only rewrites) are pure functions of the file content:\n              // no deps.\n              diskCache.save(diskKey, result, [], entryStats, map);\n            } else {\n              // Per-file dependency sets: the file's static first-party import\n              // graph, so editing an unrelated file no longer invalidates this\n              // entry (the global superset recorded the whole project — in\n              // large codebases every commit wiped the entire cache). The\n              // entry file itself is always a dep: the cache key hashes the\n              // content the BUNDLER passed, but discovery executed the file\n              // from DISK — recording it guards the (rare) divergence between\n              // the two. When the graph cannot be fully analyzed (non-literal\n              // dynamic imports, unresolvable relative specifiers), the entry\n              // is deferred and flushed in buildEnd against ONE end-of-build\n              // executed-modules superset — immediate snapshots gave every\n              // entry a distinct point-in-time copy (283 MB in the field).\n              const staticDeps = collectStaticDeps(id);\n              if (staticDeps.complete) {\n                diskCache.save(diskKey, result, [id, ...staticDeps.deps], entryStats, map);\n              } else {\n                diskCache.saveDeferred(diskKey, result, entryStats, map);\n              }\n            }\n          }\n\n          if (!result) return;\n          return { code: result, map };\n        },\n      },\n\n      watchChange(id: string) {\n        if (!SOURCE_LIKE.test(id)) return;\n        if (id.includes(\"node_modules\")) return;\n        // The changed file may be a dependency of any schema file, so both\n        // the module cache (executions) and the transform result cache are\n        // invalidated wholesale. node_modules stay warm in the loader. Disk\n        // cache entries self-validate via dep hashes — only the per-process\n        // stat memo needs resetting so changed files re-hash. Pending\n        // deferred entries predate the change and must not flush against\n        // post-change dep hashes.\n        invalidateModuleCache();\n        resetDepValidationMemo();\n        resetDepGraphMemo();\n        diskCache?.dropDeferred();\n        cache.clear();\n      },\n\n      buildEnd() {\n        // The loader's executed-modules superset is final here — persist the\n        // queued incomplete-crawl entries against one shared snapshot.\n        diskCache?.flushDeferred();\n        if (!verbose) return;\n        if (stats.schemas === 0) return;\n        log(\n          `Build summary: ${stats.optimized}/${stats.schemas} schemas optimized across ${stats.files} file(s)` +\n            (stats.failed > 0 ? `, ${stats.failed} failed` : \"\"),\n        );\n        stats.reset();\n      },\n    };\n  },\n);\n\nexport type { ZodCompilerPluginOptions } from \"./types.js\";\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/unplugin/index.ts"],"sourcesContent":["import process from \"node:process\";\nimport { createUnplugin, type UnpluginContextMeta } from \"unplugin\";\nimport type { CodegenMode } from \"../core/codegen/context.js\";\nimport { getFirstPartyModulePaths, invalidateModuleCache } from \"../loader.js\";\nimport { collectStaticDeps, resetDepGraphMemo } from \"./dep-graph.js\";\nimport { DiskCache, resetDepValidationMemo } from \"./disk-cache.js\";\nimport {\n  poolTransformOptions,\n  PoolUnavailableError,\n  resolvePoolSize,\n  TransformPool,\n} from \"./pool.js\";\nimport {\n  log,\n  shouldTransform,\n  TRANSFORM_ID_FILTER,\n  transformCodeFilter,\n  type TransformOutput,\n  type TransformSourceMap,\n  transformCodeWithMap,\n  warn,\n} from \"./transform.js\";\nimport type { BuildStats, TransformOptions, ZodCompilerPluginOptions } from \"./types.js\";\nimport { BuildStatsAccumulator } from \"./types.js\";\nimport {\n  loadVirtual,\n  RESOLVED_RUNTIME_ID_FILTER,\n  resolveVirtualId,\n  RUNTIME_SPECIFIER_FILTER,\n  VIRTUAL_RUNTIME_ID,\n  WP_RUNTIME_ID,\n} from \"./virtual.js\";\n\n/**\n * Frameworks whose resolveId/load hooks receive any import specifier, including\n * `virtual:` URIs and bare specifiers, so lean-mode cross-file dedup works.\n * webpack / rspack reject the `virtual:` URI scheme but accept bare specifiers,\n * so they use WP_RUNTIME_ID (`__zod-compiler-runtime__`) instead of VIRTUAL_RUNTIME_ID.\n */\nconst VIRTUAL_MODULE_FRAMEWORKS = new Set([\n  \"vite\",\n  \"rollup\",\n  \"rolldown\",\n  \"esbuild\",\n  \"farm\",\n  \"bun\",\n  \"rspack\",\n  \"webpack\",\n]);\n\n/** Frameworks that need the bare-specifier runtime ID instead of `virtual:`. */\nconst WP_FRAMEWORKS = new Set([\"rspack\", \"webpack\"]);\n\n/** File extensions whose changes can affect a schema module graph. */\nconst SOURCE_LIKE = /\\.([cm]?[jt]sx?|json)$/;\n\n/**\n * esbuild has no hook-filter support of its own: unplugin registers a single\n * `onLoad` covering both the load and transform hooks, and its transform shim\n * reads the file off disk before any JS-side filter runs. `onLoadFilter` is\n * the one filter esbuild itself applies (in Go, before calling into JS), so it\n * carries the union of what either hook can handle — source files for\n * transform, the resolved runtime module for load (derived from the load\n * filter so the two cannot drift; a miss there would leave the lean-mode\n * runtime import unresolved). The hooks' own filters narrow it further.\n */\nconst ESBUILD_LOAD_FILTER = new RegExp(`\\\\.[cm]?[jt]sx?$|${RESOLVED_RUNTIME_ID_FILTER.source}`);\n\nexport const unplugin = createUnplugin(\n  (options: ZodCompilerPluginOptions | undefined, meta: UnpluginContextMeta) => {\n    const schemasMode = options?.schemas ?? \"auto\";\n    const autoDiscover = schemasMode === \"auto\";\n    const outputMode = options?.output ?? \"schema\";\n    // \"compact\" keeps the Zod schema (its safeParse IS the cold error path) — so\n    // it is zod-compatible like \"schema\"; only \"bag\" drops the schema object.\n    const zodCompat = outputMode === \"schema\" || outputMode === \"compact\";\n    const compact = outputMode === \"compact\";\n    const stats = new BuildStatsAccumulator();\n    // Transform results keyed by id, validated by content: bundlers re-run\n    // transform for the same file (multiple environments, watch rebuilds) —\n    // identical content returns the cached result, changed content recomputes.\n    const cache = new Map<\n      string,\n      { code: string; result: string | null; map?: TransformSourceMap | null }\n    >();\n    const verbose = options?.verbose === true;\n    const mode: CodegenMode =\n      options?.codegenMode ?? (VIRTUAL_MODULE_FRAMEWORKS.has(meta.framework) ? \"lean\" : \"inline\");\n    const runtimeId = WP_FRAMEWORKS.has(meta.framework) ? WP_RUNTIME_ID : VIRTUAL_RUNTIME_ID;\n    // Persistent transform-result cache: discovery executes schema files (and\n    // their import graphs) in-process, and the in-memory caches die with the\n    // process — without a disk cache every test run / build re-pays that cost.\n    // Entries self-validate against dep content hashes, so watch invalidation\n    // semantics carry across processes.\n    const cacheOption = options?.cache ?? true;\n    // Opt-in worker pool. Null when disabled, or when the worker entry cannot\n    // be located (the plugin has been bundled into a single file by a\n    // consumer) — transforms then run in-process exactly as before.\n    const poolSize = resolvePoolSize(options?.parallel);\n    const pool = TransformPool.create(poolSize);\n    /** Dedupes the in-process-fallback warning to one per build. */\n    let warnedPoolFallback = false;\n    if (poolSize > 0 && pool === null) {\n      warn(\n        \"parallel was requested but the transform worker entry could not be located \" +\n          \"(is zod-compiler bundled into your build?). Falling back to in-process transforms.\",\n      );\n    }\n    /**\n     * Executed-module superset for the disk cache's deferred entries.\n     *\n     * With a pool, discovery happens in the workers, so this process's own\n     * loader has executed nothing and `getFirstPartyModulePaths()` alone would\n     * report an empty (or absent) set — silently dropping every deferred\n     * entry, which on large graphs is most of them. Both sides are unioned:\n     * the workers' reports, plus anything the in-process fallback executed\n     * here. A worker that cannot track modules at all (Bun/Deno native import)\n     * reports null, and null wins — the cache declines to persist rather than\n     * record a set it knows is incomplete.\n     */\n    const executedModuleSuperset = (): string[] | null => {\n      const local = getFirstPartyModulePaths();\n      if (pool === null) return local;\n      const remote = pool.firstPartyModulePaths();\n      if (remote === null) return null;\n      if (local === null) return remote;\n      return [...new Set([...local, ...remote])];\n    };\n    const diskCache =\n      cacheOption === false\n        ? null\n        : new DiskCache(\n            DiskCache.resolveDir(cacheOption),\n            JSON.stringify({\n              mode,\n              runtimeId,\n              output: outputMode,\n              schemas: schemasMode,\n              hoist:\n                typeof options?.hoist === \"object\"\n                  ? String(options.hoist.schemaNamePattern ?? \"default\")\n                  : (options?.hoist ?? true),\n            }),\n            executedModuleSuperset,\n          );\n    // Vite only (other bundlers ignore the field): when the plugin runs.\n    // The default compiles production builds AND test runs — tests should\n    // exercise (and benefit from) the validators that ship — while plain dev\n    // servers skip AOT cost and use the Zod fallback. Vitest runs Vite in\n    // serve mode but is detectable via the VITEST env var / \"test\" mode.\n    const viteApply =\n      options?.apply === \"all\"\n        ? undefined\n        : (options?.apply ??\n          ((_config: unknown, env: { command: string; mode: string }) =>\n            env.command === \"build\" || env.mode === \"test\" || process.env[\"VITEST\"] !== undefined));\n\n    // Hook filters (unplugin object hooks): bundlers that support them\n    // natively — Rolldown, Vite, Rollup 4.40+ — reject a module before ever\n    // calling into JS, and unplugin applies the same patterns itself\n    // everywhere else. The `code` filter is the big one: a file that never\n    // mentions zod cannot produce output, so it no longer costs a hook call,\n    // a content hash and an import scan per build.\n    const codeFilter = transformCodeFilter(options);\n    const transformFilter =\n      codeFilter === undefined\n        ? { id: TRANSFORM_ID_FILTER }\n        : { code: codeFilter, id: TRANSFORM_ID_FILTER };\n\n    return {\n      name: \"zod-compiler\",\n      enforce: \"pre\" as const,\n\n      vite: viteApply === undefined ? {} : { apply: viteApply },\n\n      esbuild: { onLoadFilter: ESBUILD_LOAD_FILTER },\n\n      resolveId: {\n        filter: { id: RUNTIME_SPECIFIER_FILTER },\n        handler(id: string) {\n          return resolveVirtualId(id);\n        },\n      },\n\n      load: {\n        filter: { id: RESOLVED_RUNTIME_ID_FILTER },\n        handler(id: string) {\n          return loadVirtual(id);\n        },\n      },\n\n      transform: {\n        filter: transformFilter,\n        async handler(code: string, id: string) {\n          // The filter covers the static half of shouldTransform(); the\n          // include/exclude options — picomatch `contains` semantics, which the\n          // native filters do not reproduce — are applied here, as is the whole\n          // check for hosts that ignore filters.\n          if (!shouldTransform(id, options)) return;\n\n          const cached = cache.get(id);\n          if (cached && cached.code === code) {\n            return cached.result === null\n              ? undefined\n              : { code: cached.result, map: cached.map ?? null };\n          }\n          if (cached) {\n            // Content changed but no watchChange fired (bundlers without the\n            // hook): drop stale module executions before re-discovering.\n            invalidateModuleCache();\n          }\n\n          // Disk cache: skip static-filtering, discovery (file execution!) and\n          // codegen entirely when a previous process already transformed this\n          // exact content and every dep it executed is unchanged.\n          const diskKey = diskCache === null ? null : diskCache.key(id, code);\n          if (diskCache !== null && diskKey !== null) {\n            const entry = diskCache.load(diskKey);\n            if (entry !== null) {\n              cache.set(id, { code, result: entry.result, map: entry.map ?? null });\n              if (entry.stats) {\n                stats.add({\n                  files: 1,\n                  schemas: entry.stats.schemas,\n                  optimized: entry.stats.optimized,\n                  failed: 0,\n                });\n              }\n              if (verbose && entry.result !== null) {\n                log(`Using cached transform for ${id}`);\n              }\n              return entry.result === null\n                ? undefined\n                : { code: entry.result, map: entry.map ?? null };\n            }\n          }\n\n          const transformOptions: TransformOptions = {\n            mode,\n            runtimeId,\n            verbose,\n            zodCompat,\n            compact,\n            autoDiscover,\n            hoist: options?.hoist,\n          };\n\n          let discoveryRan = false;\n          let substantialWork = false;\n          let uncacheable = false;\n          let fileStats: BuildStats | null = null;\n\n          const inProcess = async (): Promise<TransformOutput | null> =>\n            transformCodeWithMap(code, id, {\n              ...transformOptions,\n              onDiscovery() {\n                discoveryRan = true;\n              },\n              onSubstantialWork() {\n                substantialWork = true;\n              },\n              onUncacheableResult() {\n                uncacheable = true;\n              },\n              onBuildStats(s) {\n                fileStats = s;\n              },\n            });\n\n          let output: TransformOutput | null;\n          if (pool === null) {\n            output = await inProcess();\n          } else {\n            try {\n              // The worker reports through flags what the in-process path\n              // reports through callbacks; everything downstream reads the\n              // same four values either way.\n              const r = await pool.run(code, id, poolTransformOptions(transformOptions));\n              output = r.output;\n              discoveryRan = r.discoveryRan;\n              substantialWork = r.substantialWork;\n              uncacheable = r.uncacheable;\n              fileStats = r.stats;\n            } catch (error) {\n              // A transform's own error propagates — it will fail identically\n              // in-process, and retrying would only pay discovery twice. Only\n              // a pool fault (a worker that died holding this task) is worth\n              // redoing on this thread, so a single unhealthy worker degrades\n              // the build's speed rather than breaking it.\n              if (!(error instanceof PoolUnavailableError)) throw error;\n              // Once per build. A pool that is broken rather than unlucky\n              // fails for every remaining file, and a warning per file would\n              // bury the build's real output under thousands of copies.\n              if (!warnedPoolFallback) {\n                warnedPoolFallback = true;\n                warn(\n                  `${error.message} — compiling ${id} in-process instead. ` +\n                    `Later files take the same path without repeating this warning.`,\n                );\n              }\n              output = await inProcess();\n            }\n          }\n\n          if (fileStats !== null) stats.add(fileStats);\n          const result = output === null ? null : output.code;\n          const map = output === null ? null : output.map;\n          cache.set(id, { code, result, map });\n\n          // Persist when the transform did real work: produced output, ran\n          // discovery, or did parse-level work (hoist scan / static filter) —\n          // even when that work concluded \"no transform needed\". Null results\n          // used to be skipped on the theory that bail-outs are cheaper than a\n          // cache probe; that holds for textual bail-outs (still never\n          // persisted) but not for the scans: hoist-only mode re-paid a full\n          // scan per zod-importing file per run (35.8s/run in a field report)\n          // purely to re-derive nulls.\n          if (\n            diskCache !== null &&\n            diskKey !== null &&\n            !uncacheable &&\n            (result !== null || discoveryRan || substantialWork)\n          ) {\n            // TS narrows fileStats to null here (assignment happens inside a\n            // callback it cannot track) — widen back.\n            const s = fileStats as BuildStats | null;\n            const entryStats =\n              s === null ? undefined : { schemas: s.schemas, optimized: s.optimized };\n            if (!discoveryRan) {\n              // Discovery-free results (hoist scans, static-filter rejections,\n              // hoist-only rewrites) are pure functions of the file content:\n              // no deps.\n              diskCache.save(diskKey, result, [], entryStats, map);\n            } else {\n              // Per-file dependency sets: the file's static first-party import\n              // graph, so editing an unrelated file no longer invalidates this\n              // entry (the global superset recorded the whole project — in\n              // large codebases every commit wiped the entire cache). The\n              // entry file itself is always a dep: the cache key hashes the\n              // content the BUNDLER passed, but discovery executed the file\n              // from DISK — recording it guards the (rare) divergence between\n              // the two. When the graph cannot be fully analyzed (non-literal\n              // dynamic imports, unresolvable relative specifiers), the entry\n              // is deferred and flushed in buildEnd against ONE end-of-build\n              // executed-modules superset — immediate snapshots gave every\n              // entry a distinct point-in-time copy (283 MB in the field).\n              const staticDeps = collectStaticDeps(id);\n              if (staticDeps.complete) {\n                diskCache.save(diskKey, result, [id, ...staticDeps.deps], entryStats, map);\n              } else {\n                diskCache.saveDeferred(diskKey, result, entryStats, map);\n              }\n            }\n          }\n\n          if (!result) return;\n          return { code: result, map };\n        },\n      },\n\n      watchChange(id: string) {\n        if (!SOURCE_LIKE.test(id)) return;\n        if (id.includes(\"node_modules\")) return;\n        // The changed file may be a dependency of any schema file, so both\n        // the module cache (executions) and the transform result cache are\n        // invalidated wholesale. node_modules stay warm in the loader. Disk\n        // cache entries self-validate via dep hashes — only the per-process\n        // stat memo needs resetting so changed files re-hash. Pending\n        // deferred entries predate the change and must not flush against\n        // post-change dep hashes.\n        invalidateModuleCache();\n        // Workers hold their own module caches; the broadcast is ordered ahead\n        // of every transform posted after this point.\n        pool?.invalidate();\n        resetDepValidationMemo();\n        resetDepGraphMemo();\n        diskCache?.dropDeferred();\n        cache.clear();\n      },\n\n      buildEnd() {\n        // The loader's executed-modules superset is final here — persist the\n        // queued incomplete-crawl entries against one shared snapshot.\n        diskCache?.flushDeferred();\n        if (!verbose) return;\n        if (stats.schemas === 0) return;\n        log(\n          `Build summary: ${stats.optimized}/${stats.schemas} schemas optimized across ${stats.files} file(s)` +\n            (stats.failed > 0 ? `, ${stats.failed} failed` : \"\"),\n        );\n        stats.reset();\n      },\n    };\n  },\n);\n\nexport type { ZodCompilerPluginOptions } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;AAuCA,MAAM,4CAA4B,IAAI,IAAI;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,gCAAgB,IAAI,IAAI,CAAC,UAAU,SAAS,CAAC;;AAGnD,MAAM,cAAc;;;;;;;;;;;AAYpB,MAAM,sBAAsB,IAAI,OAAO,oBAAoB,2BAA2B,QAAQ;AAE9F,MAAa,WAAW,gBACrB,SAA+C,SAA8B;CAC5E,MAAM,cAAc,SAAS,WAAW;CACxC,MAAM,eAAe,gBAAgB;CACrC,MAAM,aAAa,SAAS,UAAU;CAGtC,MAAM,YAAY,eAAe,YAAY,eAAe;CAC5D,MAAM,UAAU,eAAe;CAC/B,MAAM,QAAQ,IAAI,sBAAsB;CAIxC,MAAM,wBAAQ,IAAI,IAGhB;CACF,MAAM,UAAU,SAAS,YAAY;CACrC,MAAM,OACJ,SAAS,gBAAgB,0BAA0B,IAAI,KAAK,SAAS,IAAI,SAAS;CACpF,MAAM,YAAY,cAAc,IAAI,KAAK,SAAS,IAAI,gBAAgB;CAMtE,MAAM,cAAc,SAAS,SAAS;CAItC,MAAM,WAAW,gBAAgB,SAAS,QAAQ;CAClD,MAAM,OAAO,cAAc,OAAO,QAAQ;;CAE1C,IAAI,qBAAqB;CACzB,IAAI,WAAW,KAAK,SAAS,MAC3B,KACE,+JAEF;;;;;;;;;;;;;CAcF,MAAM,+BAAgD;EACpD,MAAM,QAAQ,yBAAyB;EACvC,IAAI,SAAS,MAAM,OAAO;EAC1B,MAAM,SAAS,KAAK,sBAAsB;EAC1C,IAAI,WAAW,MAAM,OAAO;EAC5B,IAAI,UAAU,MAAM,OAAO;EAC3B,OAAO,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;CAC3C;CACA,MAAM,YACJ,gBAAgB,QACZ,OACA,IAAI,UACF,UAAU,WAAW,WAAW,GAChC,KAAK,UAAU;EACb;EACA;EACA,QAAQ;EACR,SAAS;EACT,OACE,OAAO,SAAS,UAAU,WACtB,OAAO,QAAQ,MAAM,qBAAqB,SAAS,IAClD,SAAS,SAAS;CAC3B,CAAC,GACD,sBACF;CAMN,MAAM,YACJ,SAAS,UAAU,QACf,KAAA,IACC,SAAS,WACR,SAAkB,QAClB,IAAI,YAAY,WAAW,IAAI,SAAS,UAAU,QAAQ,IAAI,cAAc,KAAA;CAQpF,MAAM,aAAa,oBAAoB,OAAO;CAM9C,OAAO;EACL,MAAM;EACN,SAAS;EAET,MAAM,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,UAAU;EAExD,SAAS,EAAE,cAAc,oBAAoB;EAE7C,WAAW;GACT,QAAQ,EAAE,IAAI,yBAAyB;GACvC,QAAQ,IAAY;IAClB,OAAO,iBAAiB,EAAE;GAC5B;EACF;EAEA,MAAM;GACJ,QAAQ,EAAE,IAAI,2BAA2B;GACzC,QAAQ,IAAY;IAClB,OAAO,YAAY,EAAE;GACvB;EACF;EAEA,WAAW;GACT,QA3BF,eAAe,KAAA,IACX,EAAE,IAAI,oBAAoB,IAC1B;IAAE,MAAM;IAAY,IAAI;GAAoB;GA0B9C,MAAM,QAAQ,MAAc,IAAY;IAKtC,IAAI,CAAC,gBAAgB,IAAI,OAAO,GAAG;IAEnC,MAAM,SAAS,MAAM,IAAI,EAAE;IAC3B,IAAI,UAAU,OAAO,SAAS,MAC5B,OAAO,OAAO,WAAW,OACrB,KAAA,IACA;KAAE,MAAM,OAAO;KAAQ,KAAK,OAAO,OAAO;IAAK;IAErD,IAAI,QAGF,sBAAsB;IAMxB,MAAM,UAAU,cAAc,OAAO,OAAO,UAAU,IAAI,IAAI,IAAI;IAClE,IAAI,cAAc,QAAQ,YAAY,MAAM;KAC1C,MAAM,QAAQ,UAAU,KAAK,OAAO;KACpC,IAAI,UAAU,MAAM;MAClB,MAAM,IAAI,IAAI;OAAE;OAAM,QAAQ,MAAM;OAAQ,KAAK,MAAM,OAAO;MAAK,CAAC;MACpE,IAAI,MAAM,OACR,MAAM,IAAI;OACR,OAAO;OACP,SAAS,MAAM,MAAM;OACrB,WAAW,MAAM,MAAM;OACvB,QAAQ;MACV,CAAC;MAEH,IAAI,WAAW,MAAM,WAAW,MAC9B,IAAI,8BAA8B,IAAI;MAExC,OAAO,MAAM,WAAW,OACpB,KAAA,IACA;OAAE,MAAM,MAAM;OAAQ,KAAK,MAAM,OAAO;MAAK;KACnD;IACF;IAEA,MAAM,mBAAqC;KACzC;KACA;KACA;KACA;KACA;KACA;KACA,OAAO,SAAS;IAClB;IAEA,IAAI,eAAe;IACnB,IAAI,kBAAkB;IACtB,IAAI,cAAc;IAClB,IAAI,YAA+B;IAEnC,MAAM,YAAY,YAChB,qBAAqB,MAAM,IAAI;KAC7B,GAAG;KACH,cAAc;MACZ,eAAe;KACjB;KACA,oBAAoB;MAClB,kBAAkB;KACpB;KACA,sBAAsB;MACpB,cAAc;KAChB;KACA,aAAa,GAAG;MACd,YAAY;KACd;IACF,CAAC;IAEH,IAAI;IACJ,IAAI,SAAS,MACX,SAAS,MAAM,UAAU;SAEzB,IAAI;KAIF,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,qBAAqB,gBAAgB,CAAC;KACzE,SAAS,EAAE;KACX,eAAe,EAAE;KACjB,kBAAkB,EAAE;KACpB,cAAc,EAAE;KAChB,YAAY,EAAE;IAChB,SAAS,OAAO;KAMd,IAAI,EAAE,iBAAiB,uBAAuB,MAAM;KAIpD,IAAI,CAAC,oBAAoB;MACvB,qBAAqB;MACrB,KACE,GAAG,MAAM,QAAQ,eAAe,GAAG,oFAErC;KACF;KACA,SAAS,MAAM,UAAU;IAC3B;IAGF,IAAI,cAAc,MAAM,MAAM,IAAI,SAAS;IAC3C,MAAM,SAAS,WAAW,OAAO,OAAO,OAAO;IAC/C,MAAM,MAAM,WAAW,OAAO,OAAO,OAAO;IAC5C,MAAM,IAAI,IAAI;KAAE;KAAM;KAAQ;IAAI,CAAC;IAUnC,IACE,cAAc,QACd,YAAY,QACZ,CAAC,gBACA,WAAW,QAAQ,gBAAgB,kBACpC;KAGA,MAAM,IAAI;KACV,MAAM,aACJ,MAAM,OAAO,KAAA,IAAY;MAAE,SAAS,EAAE;MAAS,WAAW,EAAE;KAAU;KACxE,IAAI,CAAC,cAIH,UAAU,KAAK,SAAS,QAAQ,CAAC,GAAG,YAAY,GAAG;UAC9C;MAaL,MAAM,aAAa,kBAAkB,EAAE;MACvC,IAAI,WAAW,UACb,UAAU,KAAK,SAAS,QAAQ,CAAC,IAAI,GAAG,WAAW,IAAI,GAAG,YAAY,GAAG;WAEzE,UAAU,aAAa,SAAS,QAAQ,YAAY,GAAG;KAE3D;IACF;IAEA,IAAI,CAAC,QAAQ;IACb,OAAO;KAAE,MAAM;KAAQ;IAAI;GAC7B;EACF;EAEA,YAAY,IAAY;GACtB,IAAI,CAAC,YAAY,KAAK,EAAE,GAAG;GAC3B,IAAI,GAAG,SAAS,cAAc,GAAG;GAQjC,sBAAsB;GAGtB,MAAM,WAAW;GACjB,uBAAuB;GACvB,kBAAkB;GAClB,WAAW,aAAa;GACxB,MAAM,MAAM;EACd;EAEA,WAAW;GAGT,WAAW,cAAc;GACzB,IAAI,CAAC,SAAS;GACd,IAAI,MAAM,YAAY,GAAG;GACzB,IACE,kBAAkB,MAAM,UAAU,GAAG,MAAM,QAAQ,4BAA4B,MAAM,MAAM,aACxF,MAAM,SAAS,IAAI,KAAK,MAAM,OAAO,WAAW,GACrD;GACA,MAAM,MAAM;EACd;CACF;AACF,CACF"}

package/dist/unplugin/pool-worker.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/unplugin/pool-worker.js

@@ -0,0 +1,116 @@
+import { getFirstPartyModulePaths, invalidateModuleCache } from "../loader.js";
+import { transformCodeWithMap } from "./transform.js";
+import { parentPort } from "node:worker_threads";
+//#region src/unplugin/pool-worker.ts
+/**
+* Worker entry for the transform pool (see ./pool.ts).
+*
+* One transform at a time, on its own module graph. The worker owns a private
+* loader — its own jiti instance, its own zod, its own execution cache — which
+* is what makes running several of these concurrently sound: the serialization
+* inside ../loader.ts exists to stop concurrent transforms from double-
+* executing a SHARED dependency, and nothing is shared across threads.
+*
+* The protocol deliberately carries no callbacks. In-process, the transform
+* reports progress through `onDiscovery`/`onSubstantialWork`/
+* `onUncacheableResult`/`onBuildStats`, all of which the disk cache reads to
+* decide whether and how to persist. Functions do not survive structured
+* cloning, so they are collapsed here into flags on a single reply — the main
+* thread reconstructs exactly the decisions it would have made.
+*/
+const port = parentPort;
+if (port === null) throw new Error("zod-compiler pool worker was started outside a worker thread");
+/**
+* Paths already reported to the pool. The executed-module list grows into the
+* thousands on a real project and the main thread only needs the union, so
+* each reply carries the delta since the last one rather than the whole set.
+*/
+let reported = /* @__PURE__ */ new Set();
+/**
+* Modules executed since the previous report, or null when this runtime cannot
+* track them at all (Bun/Deno use native import, whose cache cannot be
+* enumerated or evicted). Null propagates: the pool stops offering a superset
+* and the disk cache declines to persist deferred entries, which is what the
+* in-process path already does on those runtimes.
+*/
+function moduleDelta() {
+	const all = getFirstPartyModulePaths();
+	if (all === null) return null;
+	const delta = [];
+	for (const p of all) if (!reported.has(p)) {
+		reported.add(p);
+		delta.push(p);
+	}
+	return delta;
+}
+async function handleTransform(request) {
+	let discoveryRan = false;
+	let substantialWork = false;
+	let uncacheable = false;
+	let stats = null;
+	try {
+		const result = {
+			output: await transformCodeWithMap(request.code, request.id, {
+				...request.options,
+				onDiscovery() {
+					discoveryRan = true;
+				},
+				onSubstantialWork() {
+					substantialWork = true;
+				},
+				onUncacheableResult() {
+					uncacheable = true;
+				},
+				onBuildStats(s) {
+					stats = s;
+				}
+			}),
+			discoveryRan,
+			substantialWork,
+			uncacheable,
+			stats,
+			newModulePaths: moduleDelta()
+		};
+		return {
+			type: "result",
+			seq: request.seq,
+			result
+		};
+	} catch (error) {
+		const e = error instanceof Error ? error : new Error(String(error));
+		return {
+			type: "error",
+			seq: request.seq,
+			name: e.name,
+			message: e.message,
+			stack: e.stack
+		};
+	}
+}
+port.on("message", (request) => {
+	if (request.type === "invalidate") {
+		invalidateModuleCache();
+		reported = /* @__PURE__ */ new Set();
+		port.postMessage({
+			type: "invalidated",
+			seq: request.seq
+		});
+		return;
+	}
+	handleTransform(request).then((response) => {
+		port.postMessage(response);
+	}, (error) => {
+		const e = error instanceof Error ? error : new Error(String(error));
+		port.postMessage({
+			type: "error",
+			seq: request.seq,
+			name: e.name,
+			message: e.message,
+			stack: e.stack
+		});
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=pool-worker.js.map

package/dist/unplugin/pool-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool-worker.js","names":[],"sources":["../../src/unplugin/pool-worker.ts"],"sourcesContent":["/**\n * Worker entry for the transform pool (see ./pool.ts).\n *\n * One transform at a time, on its own module graph. The worker owns a private\n * loader — its own jiti instance, its own zod, its own execution cache — which\n * is what makes running several of these concurrently sound: the serialization\n * inside ../loader.ts exists to stop concurrent transforms from double-\n * executing a SHARED dependency, and nothing is shared across threads.\n *\n * The protocol deliberately carries no callbacks. In-process, the transform\n * reports progress through `onDiscovery`/`onSubstantialWork`/\n * `onUncacheableResult`/`onBuildStats`, all of which the disk cache reads to\n * decide whether and how to persist. Functions do not survive structured\n * cloning, so they are collapsed here into flags on a single reply — the main\n * thread reconstructs exactly the decisions it would have made.\n */\n\nimport { parentPort } from \"node:worker_threads\";\nimport { getFirstPartyModulePaths, invalidateModuleCache } from \"../loader.js\";\nimport type { PoolRequest, PoolResponse, PoolTransformResult } from \"./pool.js\";\nimport { transformCodeWithMap } from \"./transform.js\";\nimport type { BuildStats } from \"./types.js\";\n\nconst port = parentPort;\nif (port === null) {\n  throw new Error(\"zod-compiler pool worker was started outside a worker thread\");\n}\n\n/**\n * Paths already reported to the pool. The executed-module list grows into the\n * thousands on a real project and the main thread only needs the union, so\n * each reply carries the delta since the last one rather than the whole set.\n */\nlet reported = new Set<string>();\n\n/**\n * Modules executed since the previous report, or null when this runtime cannot\n * track them at all (Bun/Deno use native import, whose cache cannot be\n * enumerated or evicted). Null propagates: the pool stops offering a superset\n * and the disk cache declines to persist deferred entries, which is what the\n * in-process path already does on those runtimes.\n */\nfunction moduleDelta(): string[] | null {\n  const all = getFirstPartyModulePaths();\n  if (all === null) return null;\n  const delta: string[] = [];\n  for (const p of all) {\n    if (!reported.has(p)) {\n      reported.add(p);\n      delta.push(p);\n    }\n  }\n  return delta;\n}\n\nasync function handleTransform(\n  request: Extract<PoolRequest, { type: \"transform\" }>,\n): Promise<PoolResponse> {\n  let discoveryRan = false;\n  let substantialWork = false;\n  let uncacheable = false;\n  let stats: BuildStats | null = null;\n\n  try {\n    const output = await transformCodeWithMap(request.code, request.id, {\n      ...request.options,\n      onDiscovery() {\n        discoveryRan = true;\n      },\n      onSubstantialWork() {\n        substantialWork = true;\n      },\n      onUncacheableResult() {\n        uncacheable = true;\n      },\n      onBuildStats(s) {\n        stats = s;\n      },\n    });\n    const result: PoolTransformResult = {\n      output,\n      discoveryRan,\n      substantialWork,\n      uncacheable,\n      // TS cannot see the assignment inside the callback above.\n      stats: stats as BuildStats | null,\n      newModulePaths: moduleDelta(),\n    };\n    return { type: \"result\", seq: request.seq, result };\n  } catch (error) {\n    // The transform's own failures — a schema file that will not load in\n    // `schemas: \"explicit\"` mode — must reach the bundler with their original\n    // message, so they are forwarded rather than swallowed. The pool rebuilds\n    // the Error on the other side; only these three fields survive cloning.\n    const e = error instanceof Error ? error : new Error(String(error));\n    return { type: \"error\", seq: request.seq, name: e.name, message: e.message, stack: e.stack };\n  }\n}\n\nport.on(\"message\", (request: PoolRequest) => {\n  if (request.type === \"invalidate\") {\n    invalidateModuleCache();\n    // The loader just dropped every first-party module, so the next discovery\n    // re-executes and must re-report them: a delta against the pre-change set\n    // would report nothing and the pool's union would keep paths whose entries\n    // are gone. Harmless for cache soundness (a superset only over-\n    // invalidates) but it would grow without bound across a long watch session.\n    reported = new Set<string>();\n    port.postMessage({ type: \"invalidated\", seq: request.seq } satisfies PoolResponse);\n    return;\n  }\n\n  void handleTransform(request).then(\n    (response) => {\n      port.postMessage(response);\n    },\n    (error: unknown) => {\n      // handleTransform catches its own failures; this is the last resort for\n      // a fault in the reply path itself (an output that will not clone).\n      const e = error instanceof Error ? error : new Error(String(error));\n      port.postMessage({\n        type: \"error\",\n        seq: request.seq,\n        name: e.name,\n        message: e.message,\n        stack: e.stack,\n      } satisfies PoolResponse);\n    },\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,OAAO;AACb,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,8DAA8D;;;;;;AAQhF,IAAI,2BAAW,IAAI,IAAY;;;;;;;;AAS/B,SAAS,cAA+B;CACtC,MAAM,MAAM,yBAAyB;CACrC,IAAI,QAAQ,MAAM,OAAO;CACzB,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,KAAK,KACd,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG;EACpB,SAAS,IAAI,CAAC;EACd,MAAM,KAAK,CAAC;CACd;CAEF,OAAO;AACT;AAEA,eAAe,gBACb,SACuB;CACvB,IAAI,eAAe;CACnB,IAAI,kBAAkB;CACtB,IAAI,cAAc;CAClB,IAAI,QAA2B;CAE/B,IAAI;EAgBF,MAAM,SAA8B;GAClC,QAAA,MAhBmB,qBAAqB,QAAQ,MAAM,QAAQ,IAAI;IAClE,GAAG,QAAQ;IACX,cAAc;KACZ,eAAe;IACjB;IACA,oBAAoB;KAClB,kBAAkB;IACpB;IACA,sBAAsB;KACpB,cAAc;IAChB;IACA,aAAa,GAAG;KACd,QAAQ;IACV;GACF,CAAC;GAGC;GACA;GACA;GAEO;GACP,gBAAgB,YAAY;EAC9B;EACA,OAAO;GAAE,MAAM;GAAU,KAAK,QAAQ;GAAK;EAAO;CACpD,SAAS,OAAO;EAKd,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EAClE,OAAO;GAAE,MAAM;GAAS,KAAK,QAAQ;GAAK,MAAM,EAAE;GAAM,SAAS,EAAE;GAAS,OAAO,EAAE;EAAM;CAC7F;AACF;AAEA,KAAK,GAAG,YAAY,YAAyB;CAC3C,IAAI,QAAQ,SAAS,cAAc;EACjC,sBAAsB;EAMtB,2BAAW,IAAI,IAAY;EAC3B,KAAK,YAAY;GAAE,MAAM;GAAe,KAAK,QAAQ;EAAI,CAAwB;EACjF;CACF;CAEA,gBAAqB,OAAO,CAAC,CAAC,MAC3B,aAAa;EACZ,KAAK,YAAY,QAAQ;CAC3B,IACC,UAAmB;EAGlB,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;EAClE,KAAK,YAAY;GACf,MAAM;GACN,KAAK,QAAQ;GACb,MAAM,EAAE;GACR,SAAS,EAAE;GACX,OAAO,EAAE;EACX,CAAwB;CAC1B,CACF;AACF,CAAC"}

package/dist/unplugin/pool.d.ts

@@ -0,0 +1,162 @@
+import { CodegenMode } from "../core/codegen/context.js";
+import { HoistOptions } from "./hoist.js";
+import { BuildStats, TransformOptions } from "./types.js";
+import { TransformSourceMap } from "./transform.js";
+//#region src/unplugin/pool.d.ts
+/** The subset of TransformOptions that survives structured cloning. */
+interface PoolTransformOptions {
+  mode: CodegenMode;
+  runtimeId?: string | undefined;
+  zodCompat?: boolean | undefined;
+  compact?: boolean | undefined;
+  verbose?: boolean | undefined;
+  autoDiscover?: boolean | undefined;
+  hoist?: boolean | HoistOptions | undefined;
+}
+/** Main → worker. */
+type PoolRequest = {
+  type: "transform";
+  seq: number;
+  code: string;
+  id: string;
+  options: PoolTransformOptions;
+} | {
+  type: "invalidate";
+  seq: number;
+};
+/**
+ * What a worker observed while transforming one file: the output plus the
+ * signals the main thread's disk-cache bookkeeping needs, which arrive as
+ * callbacks in the in-process path and cannot cross a thread boundary.
+ */
+interface PoolTransformResult {
+  output: {
+    code: string;
+    map: TransformSourceMap | null;
+  } | null;
+  discoveryRan: boolean;
+  substantialWork: boolean;
+  uncacheable: boolean;
+  stats: BuildStats | null;
+  /**
+   * First-party modules this worker executed since its last report, or `null`
+   * when the worker cannot track them (Bun/Deno native import).
+   */
+  newModulePaths: string[] | null;
+}
+/** Worker → main. */
+type PoolResponse = {
+  type: "result";
+  seq: number;
+  result: PoolTransformResult;
+} | {
+  type: "error";
+  seq: number;
+  name: string;
+  message: string;
+  stack?: string | undefined;
+} | {
+  type: "invalidated";
+  seq: number;
+};
+/**
+ * Raised when the pool itself failed — a worker that would not spawn, or one
+ * that died mid-task (OOM is the realistic case; each worker holds a full
+ * module graph). Distinct from a transform's own error, which is rethrown with
+ * its original identity, because the caller's response differs: an
+ * infrastructure failure is worth retrying on the bundler thread, a schema
+ * that cannot compile is not.
+ */
+declare class PoolUnavailableError extends Error {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+/**
+ * Resolve `parallel` to a worker count. `false`/`undefined` disable the pool.
+ *
+ * `true` leaves one core for the bundler itself — it is still parsing,
+ * resolving and generating chunks while transforms run — and then caps at
+ * {@link MAX_AUTO_WORKERS}.
+ */
+declare function resolvePoolSize(parallel: boolean | number | undefined): number;
+/** Strip the callbacks from TransformOptions; what remains is cloneable. */
+declare function poolTransformOptions(options: TransformOptions): PoolTransformOptions;
+/** Terminate every live transform pool. */
+declare function disposeAllPools(): Promise<void>;
+/**
+ * A lazily grown pool of transform workers.
+ *
+ * Not a general-purpose executor: it knows the transform protocol, and it
+ * knows that a broadcast invalidation has to be ordered ahead of every
+ * subsequent transform on every worker (per-worker message delivery is FIFO,
+ * so posting the broadcast before any later task is sufficient — and the only
+ * ordering guarantee available, since a worker mid-transform cannot be
+ * interrupted).
+ */
+declare class TransformPool {
+  private readonly size;
+  private readonly entry;
+  private readonly workers;
+  private readonly queue;
+  /** In-flight requests by seq, so a worker exit can reject exactly its own. */
+  private readonly inflight;
+  private readonly executedModules;
+  /** A worker reported it cannot track executed modules — the union is unusable. */
+  private moduleTrackingUnavailable;
+  private seq;
+  private disposed;
+  /** Worker deaths since the last successful result; trips MAX_CONSECUTIVE_FAILURES. */
+  private consecutiveFailures;
+  /** Set once the breaker trips: every later run() rejects without spawning. */
+  private brokenPool;
+  private constructor();
+  /**
+   * Build a pool of `size` workers, or return null when workers are
+   * unavailable in this installation (the entry could not be located). Callers
+   * treat null as "run in-process".
+   */
+  static create(size: number): TransformPool | null;
+  /** Transform one file on a worker. Rejects with the transform's own error, or PoolUnavailableError. */
+  run(code: string, id: string, options: PoolTransformOptions): Promise<PoolTransformResult>;
+  /**
+   * Drop every worker's executed-module cache, so the next discovery re-runs
+   * changed schema graphs. Mirrors the loader's invalidateModuleCache() for
+   * the in-process path; called from watchChange.
+   *
+   * Fire-and-forget: the broadcast is posted to every live worker before any
+   * later transform can be, and per-worker FIFO delivery does the rest. A
+   * transform ALREADY executing in a worker keeps its pre-change module cache
+   * — the same window the in-process path has, where invalidation lands
+   * between awaits — and the main thread's own result cache is cleared
+   * alongside, so the file is recomputed either way.
+   */
+  invalidate(): void;
+  /**
+   * Union of the first-party modules every worker has executed, or null when
+   * any worker cannot track them. Synchronous, because DiskCache.flushDeferred
+   * runs from `buildEnd` and from a process 'exit' hook, where only
+   * synchronous work is allowed — which is why workers push deltas rather than
+   * answering a query.
+   */
+  firstPartyModulePaths(): string[] | null;
+  /** Terminate every worker. Pending and queued tasks reject. */
+  dispose(): Promise<void>;
+  /** Hand a task to an idle worker, grow the pool, or queue it. */
+  private dispatch;
+  private send;
+  private spawn;
+  private onMessage;
+  /**
+   * A worker died — OOM while holding a large module graph is the realistic
+   * cause. Its task fails with PoolUnavailableError so the caller can retry
+   * in-process, and the worker is dropped from the pool; the next dispatch
+   * spawns a replacement.
+   */
+  private onWorkerGone;
+  private drain;
+  private recordModulePaths;
+}
+//#endregion
+export { PoolRequest, PoolResponse, PoolTransformOptions, PoolTransformResult, PoolUnavailableError, TransformPool, disposeAllPools, poolTransformOptions, resolvePoolSize };
+//# sourceMappingURL=pool.d.ts.map

package/dist/unplugin/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","names":[],"sources":["../../src/unplugin/pool.ts"],"mappings":";;;;;;UA8GiB;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;EACA,kBAAkB;;;KAIR;EACN;EAAmB;EAAa;EAAc;EAAY,SAAS;;EACnE;EAAoB;;;;;;;UAOT;EACf;IAAU;IAAc,KAAK;;EAC7B;EACA;EACA;EACA,OAAO;;;;;EAKP;;;KAIU;EACN;EAAgB;EAAa,QAAQ;;EACrC;EAAe;EAAa;EAAc;EAAiB;;EAC3D;EAAqB;;;;;;;;;;cAUd,6BAA6B;EAC5B,YAAA,iBAAiB;IAAY;;;;;;;;;;iBAa3B,gBAAgB;;iBAUhB,qBAAqB,SAAS,mBAAmB;;iBA4F3C,mBAAmB;;;;;;;;;;;cA0B5B;mBACM;mBACA;mBACA;mBACA;;mBAEA;mBACA;;UAET;UACA;UACA;;UAEA;;UAEA;UAED;;;;;;SAUA,OAAO,eAAe;;EAU7B,IAAI,cAAc,YAAY,SAAS,uBAAuB,QAAQ;;;;;;;;;;;;;EA6BtE;;;;;;;;EAgBA;;EAUM,WAAW;;UAYT;UA0BA;UAUA;UAwBA;;;;;;;UAmCA;UAwBA;UA2BA"}