@vertz/ui-server 0.2.15 → 0.2.17

package/dist/bun-plugin/index.d.ts

@@ -1,6 +1,6 @@
 type ErrorCategory = "build" | "resolve" | "runtime" | "ssr";
 import { CSSExtractionResult } from "@vertz/ui-compiler";
-type DebugCategory = "manifest" | "plugin" | "ssr" | "watcher" | "ws";
+type DebugCategory = "fields" | "manifest" | "plugin" | "ssr" | "watcher" | "ws";
 interface DebugLogger {
 	log(category: DebugCategory, message: string, data?: Record<string, unknown>): void;
 	isEnabled(category: DebugCategory): boolean;
@@ -39,6 +39,10 @@ interface DiagnosticsSnapshot {
 			type: string;
 			message: string;
 		}[];
+		hmrUpdateCount: number;
+		lastHmrUpdate: string | null;
+		lastHmrFile: string | null;
+		lastHmrChanged: boolean | null;
 	};
 	errors: {
 		current: ErrorCategory | null;
@@ -53,6 +57,27 @@ interface DiagnosticsSnapshot {
 		lastChangeTime: string | null;
 	};
 	runtimeErrors: RuntimeErrorEntry[];
+	fieldSelection: {
+		manifestFileCount: number;
+		entries: Record<string, FieldSelectionDiagEntry>;
+		misses: FieldMissEntry[];
+	};
+}
+interface FieldMissEntry {
+	type: string;
+	id: string;
+	field: string;
+	querySource: string;
+	timestamp: string;
+}
+interface FieldSelectionDiagEntry {
+	queries: {
+		queryVar: string;
+		fields: string[];
+		hasOpaqueAccess: boolean;
+		crossFileFields: string[];
+		injected: boolean;
+	}[];
 }
 declare class DiagnosticsCollector {
 	private startTime;
@@ -72,6 +97,10 @@ declare class DiagnosticsCollector {
 	private manifestFileCount;
 	private manifestDurationMs;
 	private manifestWarnings;
+	private manifestHmrUpdateCount;
+	private manifestLastHmrUpdate;
+	private manifestLastHmrFile;
+	private manifestLastHmrChanged;
 	private errorCurrent;
 	private errorLastCategory;
 	private errorLastMessage;
@@ -80,6 +109,10 @@ declare class DiagnosticsCollector {
 	private watcherLastChangeTime;
 	private static readonly MAX_RUNTIME_ERRORS;
 	private runtimeErrorsBuffer;
+	private fieldSelectionManifestFileCount;
+	private fieldSelectionEntries;
+	private static readonly MAX_FIELD_MISSES;
+	private fieldMissesBuffer;
 	recordPluginConfig(filter: string, hmr: boolean, fastRefresh: boolean): void;
 	recordPluginProcess(file: string): void;
 	recordSSRReload(success: boolean, durationMs: number, error?: string): void;
@@ -87,6 +120,7 @@ declare class DiagnosticsCollector {
 		type: string;
 		message: string;
 	}[]): void;
+	recordManifestUpdate(file: string, changed: boolean, _durationMs: number): void;
 	recordHMRAssets(bundledScriptUrl: string | null, bootstrapDiscovered: boolean): void;
 	recordError(category: ErrorCategory, message: string): void;
 	recordErrorClear(): void;
@@ -94,6 +128,9 @@ declare class DiagnosticsCollector {
 	recordFileChange(file: string): void;
 	recordRuntimeError(message: string, source: string | null): void;
 	clearRuntimeErrors(): void;
+	recordFieldSelectionManifest(fileCount: number): void;
+	recordFieldSelection(file: string, entry: FieldSelectionDiagEntry): void;
+	recordFieldMiss(type: string, id: string, field: string, querySource: string): void;
 	getSnapshot(): DiagnosticsSnapshot;
 }
 import { BunPlugin as BunPlugin_seob6 } from "bun";
@@ -124,11 +161,30 @@ interface VertzBunPluginOptions {
 	logger?: DebugLogger;
 	/** Diagnostics collector for the health check endpoint. */
 	diagnostics?: DiagnosticsCollector;
+	/**
+	* Path to entity-schema.json from codegen.
+	* When provided, enables relation-aware field selection injection
+	* (include for relations, hidden field filtering, custom primary keys).
+	* Defaults to `<projectRoot>/.vertz/generated/entity-schema.json`.
+	*/
+	entitySchemaPath?: string;
+	/**
+	* Auto-split route component factories into lazy imports for code splitting.
+	* When true, `defineRoutes()` component factories referencing static imports
+	* are rewritten to `import()` calls at build time.
+	* Defaults to false (enabled explicitly for production client builds).
+	*/
+	routeSplitting?: boolean;
 }
 /** CSS extractions tracked across all transformed files (for dead CSS elimination). */
 type FileExtractionsMap = Map<string, CSSExtractionResult>;
 /** Map of source file path to CSS sidecar file path (for debugging). */
 type CSSSidecarMap = Map<string, string>;
+/** Result of updating a single file's manifest during HMR. */
+interface ManifestUpdateResult {
+	/** Whether the manifest's reactivity shape changed compared to the previous version. */
+	changed: boolean;
+}
 interface VertzBunPluginResult {
 	/** The Bun plugin to pass to Bun.build or bunfig.toml. */
 	plugin: BunPlugin_seob6;
@@ -136,6 +192,22 @@ interface VertzBunPluginResult {
 	fileExtractions: FileExtractionsMap;
 	/** Map of source file to CSS sidecar file path (for debugging). */
 	cssSidecarMap: CSSSidecarMap;
+	/**
+	* Regenerate a single file's manifest during HMR.
+	* Returns whether the manifest shape changed (triggering cache invalidation).
+	*/
+	updateManifest(filePath: string, sourceText: string): ManifestUpdateResult;
+	/**
+	* Remove a file's manifest when the file is deleted.
+	* Returns whether the file had a manifest entry.
+	*/
+	deleteManifest(filePath: string): boolean;
+	/**
+	* Reload the entity schema manifest from disk.
+	* Call this when entity-schema.json changes (e.g., after codegen re-runs).
+	* Returns whether the schema changed.
+	*/
+	reloadEntitySchema(): boolean;
 }
 /**
 * Create a Vertz Bun plugin with CSS sidecar support and optional Fast Refresh.