first commit

2026-10-07 18:56:27 +02:00
commit 2a8a60b725
7768 changed files with 1550851 additions and 0 deletions
@@ -0,0 +1,192 @@
+/**
+ * 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.
+ * @typedef {{ ids: string[], localCount: number, edges: number[][], bindings?: Record<number, (string[] | null)[]>, dynamicEdges?: Record<number, number[]> }} ModuleGraphDelta
+ * @typedef {{ createModuleHotContext(moduleId: string): any, onModuleCacheRemoval(moduleId: string): void }} DevRuntimeHooks
+ */
+export class MissingFactoryError {
+    /**
+     * @param {string} id
+     */
+    constructor(id: string);
+    id: string;
+}
+export class DevRuntime {
+    /**
+     * @param {string} clientId
+     */
+    constructor(clientId: string);
+    /**
+     * Client ID generated at runtime initialization, used for lazy compilation requests.
+     * @type {string}
+     */
+    clientId: string;
+    /**
+     * Static import edges from `registerGraph` — entries persist across `removeModuleCache`
+     * and change only by replacement from a newer payload (last write wins).
+     * `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.
+     * @type {Map<string, Set<string>>}
+     */
+    importers: Map<string, Set<string>>;
+    /**
+     * Dynamic `import()` edges from `registerGraph`, keyed by importer — mirror of
+     * `staticImports` for the dynamic reverse index.
+     * @type {Map<string, { edges: string[] }>}
+     */
+    dynamicImports: Map<string, {
+        edges: string[];
+    }>;
+    /**
+     * Reverse index over the dynamic imports.
+     * @type {Map<string, Set<string>>}
+     */
+    dynamicImporters: Map<string, Set<string>>;
+    /**
+     * The module cache. Membership means "this module's side effects ran in this tab" —
+     * registration is emitted ahead of every module body, and nothing un-registers on
+     * unwind, so a factory that throws mid-body stays registered. A `Map` rather than a
+     * plain object: HMR eviction deletes entries, and a `delete` on an object drops V8
+     * into dictionary mode, taxing every later lookup on the hottest read path.
+     * @type {Map<string, Module>}
+     */
+    moduleCache: Map<string, Module>;
+    /**
+     * Re-runnable factories from HMR patches and lazy chunks. The initial bundle stays
+     * scope-hoisted and contributes none.
+     * @type {Map<string, (id: string) => void>}
+     */
+    factories: Map<string, (id: string) => void>;
+    /**
+     * 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.
+     * @type {DevRuntimeHooks | null}
+     */
+    hooks: DevRuntimeHooks | null;
+    /**
+     * @param {ModuleGraphDelta} delta
+     */
+    registerGraph(delta: ModuleGraphDelta): void;
+    /**
+     * @param {string} id
+     * @param {(id: string) => void} fn
+     */
+    registerFactory(id: string, fn: (id: string) => void): void;
+    /**
+     * @param {string} id
+     * @param {{ exports: any }} [exportsHolder]
+     */
+    registerModule(id: string, exportsHolder?: {
+        exports: any;
+    }): void;
+    /**
+     * @param {string} id
+     * @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
+     */
+    isExecuted(id: string): any;
+    /**
+     * @param {string} id
+     */
+    hasFactory(id: string): any;
+    /**
+     * Module-cache delete only — static imports and factories persist. Removal is what
+     * re-arms a cache-gated factory for `initModule`.
+     * @param {string} id
+     */
+    removeModuleCache(id: string): void;
+    /**
+     * The one re-execution gate: registered → return the live exports; otherwise run the
+     * mapped factory (which registers itself first, then runs the body).
+     * @param {string} id
+     */
+    initModule(id: string): any;
+    /**
+     * @param {string} id
+     */
+    loadExports(id: string): any;
+    /**
+     * @param {string} moduleId
+     */
+    createModuleHotContext(moduleId: string): any;
+    /** @internal */
+    __toESM: any;
+    /** @internal */
+    __toCommonJS: any;
+    /** @internal */
+    __exportAll: any;
+    /**
+     * @param {boolean} [isNodeMode]
+     * @returns {(mod: any) => any}
+     * @internal
+     */
+    __toDynamicImportESM: (isNodeMode?: boolean) => (mod: any) => any;
+    /** @internal */
+    __reExport: any;
+}
+/**
+ * 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.
+ */
+export type ModuleGraphDelta = {
+    ids: string[];
+    localCount: number;
+    edges: number[][];
+    bindings?: Record<number, (string[] | null)[]>;
+    dynamicEdges?: Record<number, number[]>;
+};
+/**
+ * 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.
+ */
+export type DevRuntimeHooks = {
+    createModuleHotContext(moduleId: string): any;
+    onModuleCacheRemoval(moduleId: string): void;
+};
+declare class Module {
+    /**
+     * @param {string} id
+     */
+    constructor(id: string);
+    /**
+     * @type {{ exports: any }}
+     */
+    exportsHolder: {
+        exports: any;
+    };
+    /**
+     * @type {string}
+     */
+    id: string;
+    get exports(): any;
+}
+export {};