@voidzero-dev/vite-plus-core 1.0.0 → 1.2.0

package/dist/rolldown/experimental-runtime-types.d.ts

@@ -1,8 +1,12 @@
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
- * @typedef {{ ids: string[], localCount: number, edges: number[][], dynamicEdges?: number[][] }} ModuleGraphDelta
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
+ * @typedef {{ ids: string[], localCount: number, edges: number[][], bindings?: Record<number, (string[] | null)[]>, dynamicEdges?: Record<number, number[]>, stamps?: Record<number, number> }} ModuleGraphDelta
  * @typedef {{ createModuleHotContext(moduleId: string): any, onModuleCacheRemoval(moduleId: string): void }} DevRuntimeHooks
  */
 export class MissingFactoryError {
@@ -25,10 +29,12 @@ export class DevRuntime {
     /**
      * Static import edges from `registerGraph` — entries persist across `removeModuleCache`
      * and change only by replacement from a newer payload (last write wins).
-     * @type {Map<string, { edges: string[] }>}
+     * `bindings` is the payload row as sent; `getImportedBindings` resolves a missing entry.
+     * @type {Map<string, { edges: string[], bindings: (string[] | null)[] | undefined }>}
      */
     staticImports: Map<string, {
         edges: string[];
+        bindings: (string[] | null)[] | undefined;
     }>;
     /**
      * Reverse index over the static imports.
@@ -63,6 +69,14 @@ export class DevRuntime {
      * @type {Map<string, (id: string) => void>}
      */
     factories: Map<string, (id: string) => void>;
+    /**
+     * A late payload (a slow lazy chunk after an HMR patch) must not replace newer rows or
+     * factories.
+     * @type {Map<string, number>}
+     */
+    rowStamps: Map<string, number>;
+    /** @type {Map<string, number>} */
+    factoryStamps: Map<string, number>;
     /**
      * Installed by the dev client at boot. The runtime is a store + executor and makes
      * no HMR decisions; accepting, disposing, and reloading live behind these hooks.
@@ -76,8 +90,9 @@ export class DevRuntime {
     /**
      * @param {string} id
      * @param {(id: string) => void} fn
+     * @param {number} [stamp]
      */
-    registerFactory(id: string, fn: (id: string) => void): void;
+    registerFactory(id: string, fn: (id: string) => void, stamp?: number): void;
     /**
      * @param {string} id
      * @param {{ exports: any }} [exportsHolder]
@@ -90,6 +105,13 @@ export class DevRuntime {
      * @returns {string[]}
      */
     getImporters(id: string): string[];
+    /**
+     * `"*"` means the whole namespace, an empty list a side-effect-only import, `undefined` no edge.
+     * @param {string} importer
+     * @param {string} id
+     * @returns {string[] | undefined}
+     */
+    getImportedBindings(importer: string, id: string): string[] | undefined;
     /**
      * @param {string} id
      */
@@ -134,20 +156,30 @@ export class DevRuntime {
     __reExport: any;
 }
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
  */
 export type ModuleGraphDelta = {
     ids: string[];
     localCount: number;
     edges: number[][];
-    dynamicEdges?: number[][];
+    bindings?: Record<number, (string[] | null)[]>;
+    dynamicEdges?: Record<number, number[]>;
+    stamps?: Record<number, number>;
 };
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
  */
 export type DevRuntimeHooks = {
     createModuleHotContext(moduleId: string): any;

package/dist/rolldown/experimental-runtime.d.ts

@@ -1,8 +1,12 @@
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
- * @typedef {{ ids: string[], localCount: number, edges: number[][], dynamicEdges?: number[][] }} ModuleGraphDelta
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
+ * @typedef {{ ids: string[], localCount: number, edges: number[][], bindings?: Record<number, (string[] | null)[]>, dynamicEdges?: Record<number, number[]>, stamps?: Record<number, number> }} ModuleGraphDelta
  * @typedef {{ createModuleHotContext(moduleId: string): any, onModuleCacheRemoval(moduleId: string): void }} DevRuntimeHooks
  */
 export class MissingFactoryError {
@@ -25,10 +29,12 @@ export class DevRuntime {
     /**
      * Static import edges from `registerGraph` — entries persist across `removeModuleCache`
      * and change only by replacement from a newer payload (last write wins).
-     * @type {Map<string, { edges: string[] }>}
+     * `bindings` is the payload row as sent; `getImportedBindings` resolves a missing entry.
+     * @type {Map<string, { edges: string[], bindings: (string[] | null)[] | undefined }>}
      */
     staticImports: Map<string, {
         edges: string[];
+        bindings: (string[] | null)[] | undefined;
     }>;
     /**
      * Reverse index over the static imports.
@@ -63,6 +69,14 @@ export class DevRuntime {
      * @type {Map<string, (id: string) => void>}
      */
     factories: Map<string, (id: string) => void>;
+    /**
+     * A late payload (a slow lazy chunk after an HMR patch) must not replace newer rows or
+     * factories.
+     * @type {Map<string, number>}
+     */
+    rowStamps: Map<string, number>;
+    /** @type {Map<string, number>} */
+    factoryStamps: Map<string, number>;
     /**
      * Installed by the dev client at boot. The runtime is a store + executor and makes
      * no HMR decisions; accepting, disposing, and reloading live behind these hooks.
@@ -76,8 +90,9 @@ export class DevRuntime {
     /**
      * @param {string} id
      * @param {(id: string) => void} fn
+     * @param {number} [stamp]
      */
-    registerFactory(id: string, fn: (id: string) => void): void;
+    registerFactory(id: string, fn: (id: string) => void, stamp?: number): void;
     /**
      * @param {string} id
      * @param {{ exports: any }} [exportsHolder]
@@ -90,6 +105,13 @@ export class DevRuntime {
      * @returns {string[]}
      */
     getImporters(id: string): string[];
+    /**
+     * `"*"` means the whole namespace, an empty list a side-effect-only import, `undefined` no edge.
+     * @param {string} importer
+     * @param {string} id
+     * @returns {string[] | undefined}
+     */
+    getImportedBindings(importer: string, id: string): string[] | undefined;
     /**
      * @param {string} id
      */
@@ -134,20 +156,30 @@ export class DevRuntime {
     __reExport: any;
 }
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
  */
 export type ModuleGraphDelta = {
     ids: string[];
     localCount: number;
     edges: number[][];
-    dynamicEdges?: number[][];
+    bindings?: Record<number, (string[] | null)[]>;
+    dynamicEdges?: Record<number, number[]>;
+    stamps?: Record<number, number>;
 };
 /**
- * Compiler-emitted module-graph delta — pure topology (static + dynamic edges).
+ * Compiler-emitted module-graph delta — topology (static + dynamic edges).
  * `ids[0, localCount)` are the modules this payload carries; `ids[localCount, …)` are foreign edge targets.
  * `edges[i]` / `dynamicEdges[i]` are the static / dynamic-`import()` out-edges of `ids[i]`.
+ * `bindings[i][j]` are the export names `ids[i]` imports through `edges[i][j]`. `bindings` holds
+ * only some rows; a missing row, or a missing or `null` entry, means the whole namespace.
+ * `dynamicEdges` also holds only some rows; a missing row means no dynamic edges.
+ * `stamps[i]` is the rebuild stamp of `ids[i]`; a missing row means 0.
  */
 export type DevRuntimeHooks = {
     createModuleHotContext(moduleId: string): any;