vite-plugin-zephyr 1.2.4 → 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.d.ts

@@ -1,7 +1,7 @@
-export { withZephyr } from './lib/vite-plugin-zephyr';
-export { withZephyrPartial } from './lib/vite-plugin-zephyr-partial';
-export type { WithZephyrOptions } from './lib/vite-plugin-zephyr';
-export type { VitePartialBuildOptions } from './lib/internal/partial-build-scope';
-export type { ModuleFederationOptions } from './lib/internal/mf-vite-etl/ensure_runtime_plugin';
+export { withZephyr } from './lib/vite-plugin-zephyr.js';
+export { withZephyrPartial } from './lib/vite-plugin-zephyr-partial.js';
+export type { WithZephyrOptions } from './lib/vite-plugin-zephyr.js';
+export type { VitePartialBuildOptions } from './lib/internal/partial-build-scope.js';
+export type { ModuleFederationOptions } from './lib/internal/mf-vite-etl/ensure_runtime_plugin.js';
 export type { ZephyrBuildHooks, DeploymentInfo } from 'zephyr-agent';
 //# sourceMappingURL=index.d.ts.map

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.d.mts

@@ -1,5 +1,4 @@
-import type { Plugin, PluginOption } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin, PluginOption } from 'vite' with { 'resolution-mode': 'import'
 };
 import type { ModuleFederationOptions } from '../mf-vite-etl/ensure_runtime_plugin.mjs';
 export interface ViteMFPlugin {

package/dist/lib/internal/extract/extract_mf_plugin.d.ts

@@ -1,7 +1,6 @@
-import type { Plugin, PluginOption } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin, PluginOption } from 'vite' with { 'resolution-mode': 'import'
 };
-import type { ModuleFederationOptions } from '../mf-vite-etl/ensure_runtime_plugin';
+import type { ModuleFederationOptions } from '../mf-vite-etl/ensure_runtime_plugin.js';
 export interface ViteMFPlugin {
     _options: ModuleFederationOptions;
 }

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.d.ts

@@ -1,4 +1,4 @@
 import { type ZeBuildAssetsMap, type ZephyrEngine } from 'zephyr-agent';
-import type { ZephyrInternalOptions } from '../types/zephyr-internal-options';
+import type { ZephyrInternalOptions } from '../types/zephyr-internal-options.js';
 export declare function extract_vite_assets_map(_zephyr_engine: ZephyrEngine, vite_internal_options: ZephyrInternalOptions): Promise<ZeBuildAssetsMap>;
 //# sourceMappingURL=extract_vite_assets_map.d.ts.map

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.d.ts

@@ -1,5 +1,5 @@
 import { type ZephyrBuildTarget } from 'zephyr-agent';
-import type { ZephyrOutputAsset } from '../types/zephyr-output';
+import type { ZephyrOutputAsset } from '../types/zephyr-output.js';
 interface LoadPublicDirOptions {
     outDir: string;
     publicDir: string;

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.d.ts

@@ -1,4 +1,4 @@
-import type { ZephyrInternalOptions } from '../types/zephyr-internal-options';
-import type { ZephyrOutputBundle } from '../types/zephyr-output';
+import type { ZephyrInternalOptions } from '../types/zephyr-internal-options.js';
+import type { ZephyrOutputBundle } from '../types/zephyr-output.js';
 export declare function loadStaticAssets(vite_internal_options: ZephyrInternalOptions): Promise<ZephyrOutputBundle>;
 //# sourceMappingURL=load_static_assets.d.ts.map

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.d.ts

@@ -1,5 +1,5 @@
 import { type ZephyrBuildTarget } from 'zephyr-agent';
-import type { ZephyrOutputAsset } from '../types/zephyr-output';
+import type { ZephyrOutputAsset } from '../types/zephyr-output.js';
 interface LoadStaticEntriesOptions {
     root: string;
     outDir: string;

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.d.ts

@@ -1,5 +1,5 @@
 import { type ZephyrBuildTarget } from 'zephyr-agent';
-import type { ZephyrOutput, ZephyrOutputBundle } from '../types/zephyr-output';
+import type { ZephyrOutput, ZephyrOutputBundle } from '../types/zephyr-output.js';
 export interface MergeViteOutputAssetsOptions {
     /** TAP paths are protocol values and must already use their published spelling. */
     target?: ZephyrBuildTarget;

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.d.ts

@@ -1,4 +1,4 @@
-import type { ModuleFederationManifestOptions, ModuleFederationOptions } from './ensure_runtime_plugin';
+import type { ModuleFederationManifestOptions, ModuleFederationOptions } from './ensure_runtime_plugin.js';
 /** The established single-container snapshot shape. */
 export interface ViteLegacyModuleFederationConfig {
     name: string;

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.d.ts

@@ -1,5 +1,5 @@
 import type { ZephyrBuildTarget } from 'zephyr-agent';
-import type { ZephyrOutputBundle } from './zephyr-output';
+import type { ZephyrOutputBundle } from './zephyr-output.js';
 export interface ZephyrInternalOptions {
     root: string;
     outDir: string;

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.d.mts

@@ -1,5 +1,4 @@
-import type { Plugin } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin } from 'vite' with { 'resolution-mode': 'import'
 };
 import { type VitePartialBuildOptions } from './internal/partial-build-scope.mjs';
 export declare function withZephyrPartial(options?: VitePartialBuildOptions): Plugin;

package/dist/lib/vite-plugin-zephyr-partial.d.ts

@@ -1,6 +1,5 @@
-import type { Plugin } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin } from 'vite' with { 'resolution-mode': 'import'
 };
-import { type VitePartialBuildOptions } from './internal/partial-build-scope';
+import { type VitePartialBuildOptions } from './internal/partial-build-scope.js';
 export declare function withZephyrPartial(options?: VitePartialBuildOptions): Plugin;
 //# sourceMappingURL=vite-plugin-zephyr-partial.d.ts.map

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";

package/dist/lib/vite-plugin-zephyr.d.mts

@@ -1,5 +1,4 @@
-import type { Plugin } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin } from 'vite' with { 'resolution-mode': 'import'
 };
 import { type ZephyrBuildHooks, type ZephyrBuildTarget } from 'zephyr-agent';
 import { type ModuleFederationOptions } from './internal/mf-vite-etl/ensure_runtime_plugin.mjs';

package/dist/lib/vite-plugin-zephyr.d.ts

@@ -1,9 +1,8 @@
-import type { Plugin } from 'vite' with {
-    'resolution-mode': 'import'
+import type { Plugin } from 'vite' with { 'resolution-mode': 'import'
 };
 import { type ZephyrBuildHooks, type ZephyrBuildTarget } from 'zephyr-agent';
-import { type ModuleFederationOptions } from './internal/mf-vite-etl/ensure_runtime_plugin';
-import { type VitePartialBuildOptions } from './internal/partial-build-scope';
+import { type ModuleFederationOptions } from './internal/mf-vite-etl/ensure_runtime_plugin.js';
+import { type VitePartialBuildOptions } from './internal/partial-build-scope.js';
 export interface WithZephyrOptions {
     /** Zephyr build target, including the `tap-app` mini-app artifact family. */
     target?: ZephyrBuildTarget;