vite-plugin-zephyr 1.3.0 → 1.4.0

package/README.md

@@ -58,11 +58,52 @@ export default defineConfig({
 
 ### Multi-Environment and SSR Builds
 
-Vite 6, 7, and 8 environment builds are collected across `client`, `server`, RSC, or custom
-child environments and published once after `buildApp` completes. The plugin validates
-that each current environment contributed output; persisted partial-build contributions
-are merged atomically. Vite 5 and watch builds use the direct single-environment upload
-path.
+Vite 7 and 8 application-builder invocations collect output across `client`, `server`,
+RSC, or custom child environments and publish once through the `buildApp` hook. The
+plugin validates that each current environment contributed output; persisted
+partial-build contributions are merged atomically. Programmatic `vite.build()` calls,
+including Slidev builds, use the direct single-environment upload path, as do Vite 5
+and single-environment watch builds.
+
+When `createBuilder()` instantiates multiple environments, publish through
+`builder.buildApp()`. Calling `builder.build(environment)` individually is rejected to
+prevent separate, incomplete deployments. This check tracks actual environment
+creation, so ordinary legacy SSR builds can still select one server environment.
+
+Non-watch programmatic builds collect every output format and publish one combined
+snapshot when the bundler closes, after all expected writes succeed. External partial
+output is claimed and committed once for that snapshot. Library `formats` and explicit
+output arrays are both supported. Separate output directories are preserved relative
+to their common root; TAP artifact paths remain unchanged.
+
+Direct SSR builds infer `snapshotType: 'ssr'` from the selected server build and use its
+emitted entry chunk, including renamed or hashed filenames. Explicit `snapshotType` and
+`entrypoint` options take precedence. Multiple server entry chunks require an explicit
+emitted `entrypoint`. TAP builds do not infer SSR unless explicitly requested.
+
+For direct non-watch publication, Zephyr must observe the final `outputOptions`,
+`writeBundle` and `closeBundle` hooks. Output plugins are checked after normal option
+hooks have returned their changes. Later post-ordered hooks and unresolved asynchronous
+output plugins are rejected because they could change the writers or fail after Zephyr
+records success. Application-builder and watch publication keep their own lifecycles.
+
+If publication and partial-claim rollback both fail, the rollback error is logged
+separately and the original publication error keeps the configured throw-or-log behavior.
+
+Vite 6 does not dispatch plugin `buildApp` hooks. Its non-watch publication supports only
+a single environment without an explicit `builder` configuration; other configurations
+are rejected to avoid publishing incomplete output. Use Vite 7 or newer for coordinated
+application builds.
+
+Place `withZephyr()` before other plugins that combine `enforce: 'pre'` with a
+pre-ordered `buildApp` hook. Zephyr checks this order before building so it can start
+collecting output before any application build hook compiles an environment. The
+ordering check also applies to legacy builds carrying those plugins.
+
+Files generated by a framework after `vite.build()` returns are outside the Vite upload
+lifecycle. For example, Slidev can generate a PDF, an OG image, `404.html`, and
+`_redirects` after Vite finishes; those files need a separate post-build publication
+step if they must be included.
 
 ```typescript
 withZephyr({

package/dist/index.mjs

@@ -1,3 +1,2 @@
-import "node:module";
 export { withZephyr } from "./lib/vite-plugin-zephyr.mjs";
 export { withZephyrPartial } from "./lib/vite-plugin-zephyr-partial.mjs";

package/dist/lib/internal/extract/extract-entrypoint.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ze_log } from "zephyr-agent";
 import { normalizeEntrypoint } from "../utils/normalize-entrypoint.mjs";
 function extractEntrypoint(config) {

package/dist/lib/internal/extract/extract_mf_plugin.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 function isPlugin(plugin) {
     return !!plugin && 'object' == typeof plugin && 'name' in plugin;
 }

package/dist/lib/internal/extract/extract_vite_assets_map.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { buildAssetsMap } from "zephyr-agent";
 import { loadStaticAssets } from "./load_static_assets.mjs";
 import { mergeViteOutputAssets } from "./merge_vite_output_assets.mjs";

package/dist/lib/internal/extract/load_public_dir.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { basename, resolve } from "node:path";
 import { readDirRecursiveWithContents } from "zephyr-agent";
 import { normalizeFilesystemVitePath, normalizeVitePath } from "../utils/normalize-vite-path.mjs";

package/dist/lib/internal/extract/load_static_assets.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { load_public_dir } from "./load_public_dir.mjs";
 import { load_static_entries } from "./load_static_entries.mjs";
 import { mergeViteOutputAssets } from "./merge_vite_output_assets.mjs";

package/dist/lib/internal/extract/load_static_entries.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { basename, resolve } from "node:path";
 import { readDirRecursiveWithContents } from "zephyr-agent";
 import { normalizeFilesystemVitePath, normalizeVitePath } from "../utils/normalize-vite-path.mjs";

package/dist/lib/internal/extract/merge_vite_output_assets.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError } from "zephyr-agent";
 import { normalizeVitePath } from "../utils/normalize-vite-path.mjs";
 function outputBytes(asset) {

package/dist/lib/internal/mf-vite-etl/ensure_runtime_plugin.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
 import { dirname as __rspack_dirname } from "node:path";
 var __rspack_import_meta_dirname__ = __rspack_dirname(__rspack_fileURLToPath(import.meta.url));

package/dist/lib/internal/mf-vite-etl/extract-mf-vite-remotes.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { readPackageJson } from "zephyr-agent";
 function extract_remotes_dependencies(root, mfConfig) {
     const { zephyrDependencies } = readPackageJson(root);

package/dist/lib/internal/mf-vite-etl/federation-metadata.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError, resolveMfManifestPath } from "zephyr-agent";
 function nonEmptyString(value) {
     return 'string' == typeof value && value.trim() ? value : void 0;

package/dist/lib/internal/partial-build-scope.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrError } from "zephyr-agent";
 function firstDefined(parts) {
     return parts.every((part)=>!!part) ? parts.join(':') : void 0;

package/dist/lib/internal/types/zephyr-internal-options.mjs

@@ -1 +1 @@
-import "node:module";
+export { };

package/dist/lib/internal/types/zephyr-output.mjs

@@ -1 +1 @@
-import "node:module";
+export { };

package/dist/lib/internal/utils/normalize-entrypoint.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 function normalizeEntrypoint(entrypoint) {
     let normalized = entrypoint.trim();
     normalized = normalized.split('\\').join('/');

package/dist/lib/internal/utils/normalize-vite-path.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { sep } from "node:path";
 function normalizeVitePath(pathname) {
     return pathname.replace(/\\/g, '/');

package/dist/lib/vite-plugin-zephyr-partial.mjs

@@ -1,4 +1,3 @@
-import "node:module";
 import { ZeErrors, ZephyrEngine, ZephyrError, assertZephyrBuildTarget, handleGlobalError, savePartialAssetMap } from "zephyr-agent";
 import { extract_vite_assets_map } from "./internal/extract/extract_vite_assets_map.mjs";
 import { requireVitePartialBuildScope } from "./internal/partial-build-scope.mjs";