@nativescript/vite 8.0.0-alpha.4 → 8.0.0-alpha.40

package/hmr/server/device-transform-helpers.js

@@ -0,0 +1,369 @@
+// Pure helpers for the device code-transform subsystem: import-path
+// normalization, node_modules/vendor specifier resolution, dependency
+// collection support, and provenance preludes. Shared by
+// process-code-for-device.ts and rewrite-imports.ts.
+import * as path from 'path';
+import * as PAT from './constants.js';
+import { getProjectRootPath } from '../../helpers/project.js';
+import { isLikelyNativeScriptRuntimePluginSpecifier, isNativeScriptCoreModule, isNativeScriptPluginModule, normalizeNativeScriptCoreSpecifier, normalizeNodeModulesSpecifier, resolveNodeModulesPackageBoundary, resolveVendorFromCandidate, viteDepsPathToBareSpecifier } from './websocket-module-specifiers.js';
+import { collectTopLevelImportRecords } from './websocket-served-module-helpers.js';
+// Bare specifiers and special skip patterns (virtual, data:, etc.)
+const VENDOR_PACKAGES = /^[A-Za-z@][^:\/\s]*$/;
+const SKIP_PATTERNS = /^(?:data:|blob:|node:|virtual:|vite:|\0|\/@@?id|\/__vite|__vite|__x00__)/;
+// One warning per dep so vendor-manifest misses are visible without spamming
+// the console on every served module.
+const warnedVendorMisses = new Set();
+/**
+ * Vendor-manifest miss fallback — e.g. `emoji-regex`, a transitive dep of
+ * @nativescript/core that is never part of the vendor bundle. Dropping the
+ * import leaves the consumer with an undefined binding at runtime
+ * ("emojiRegexModule is not defined"), so instead derive a bare specifier from
+ * Vite's flattened prebundle id; the later rewriteImports pass routes it to
+ * /ns/m/node_modules/<pkg> and the package is served over HTTP like any other
+ * node_modules subpath.
+ *
+ * Vite's flattenId encodes `/` as `_`, so the decoding is ambiguous (package
+ * names may legitimately contain `_`). For scoped ids the first `_` is the
+ * scope slash. Each candidate is verified against node_modules on disk before
+ * being committed; if nothing resolves, the first candidate is used anyway —
+ * a loud 404 on device beats a silent undefined binding.
+ */
+function bareSpecifierFromFlatDepPath(depPath) {
+    const flat = depPath.split('?')[0].replace(/\.m?js$/, '');
+    const candidates = flat.startsWith('@') ? [flat.replace('_', '/'), flat] : [flat];
+    let resolved = null;
+    for (const candidate of candidates) {
+        try {
+            const { packageName } = resolveNodeModulesPackageBoundary(candidate, getProjectRootPath());
+            if (packageName) {
+                resolved = candidate;
+                break;
+            }
+        }
+        catch { }
+    }
+    const bareSpecifier = resolved || candidates[0];
+    if (!warnedVendorMisses.has(depPath)) {
+        warnedVendorMisses.add(depPath);
+        console.warn(`[ns-vite] vendor-manifest miss: prebundled dep '${depPath}' is not in the vendor bundle — serving '${bareSpecifier}' over HTTP via /ns/m/node_modules/${resolved ? '' : ' (could not verify the package on disk; the specifier is a best-effort decode of the flattened id)'}.`);
+    }
+    return bareSpecifier;
+}
+function rewriteVitePrebundleImportsForDevice(code, preserveVendorImports) {
+    const imports = collectTopLevelImportRecords(code);
+    if (!imports.length) {
+        return code;
+    }
+    const edits = [];
+    for (const imp of imports) {
+        const source = imp.source;
+        const depMatch = source.match(/(?:^|\/)node_modules\/\.vite\/deps\/(.+)$/);
+        const depPath = depMatch?.[1] || (source.startsWith('.vite/deps/') ? source.slice('.vite/deps/'.length) : null);
+        if (!depPath) {
+            continue;
+        }
+        let replacement = '';
+        if (preserveVendorImports) {
+            const canonical = resolveVendorFromCandidate(`.vite/deps/${depPath}`);
+            let bareSpecifier = canonical || viteDepsPathToBareSpecifier(depPath);
+            if (!bareSpecifier) {
+                bareSpecifier = bareSpecifierFromFlatDepPath(depPath);
+            }
+            if (bareSpecifier) {
+                replacement = imp.text.replace(source, bareSpecifier);
+            }
+        }
+        edits.push({
+            start: imp.start,
+            end: imp.end,
+            text: replacement,
+        });
+    }
+    if (!edits.length) {
+        return code;
+    }
+    let next = code;
+    for (const edit of edits.sort((left, right) => right.start - left.start)) {
+        next = next.slice(0, edit.start) + edit.text + next.slice(edit.end);
+    }
+    return next;
+}
+function buildNodeModuleProvenancePrelude(sourceId) {
+    if (!sourceId) {
+        return '';
+    }
+    const cleaned = sourceId.replace(PAT.QUERY_PATTERN, '');
+    let normalized = normalizeNodeModulesSpecifier(cleaned);
+    if (!normalized) {
+        const viteDepsMatch = cleaned.match(/(?:^|\/)node_modules\/\.vite\/deps\/([^?#]+)/);
+        if (viteDepsMatch?.[1]) {
+            normalized = `.vite/deps/${viteDepsMatch[1]}`;
+        }
+    }
+    if (!normalized) {
+        return '';
+    }
+    let packageSpecifier = normalized;
+    let via = 'node_modules';
+    if (normalized.startsWith('.vite/deps/')) {
+        via = 'vite-deps';
+        packageSpecifier = viteDepsPathToBareSpecifier(normalized.slice('.vite/deps/'.length)) || normalized;
+    }
+    const rootPackage = resolveNodeModulesPackageBoundary(packageSpecifier, getProjectRootPath()).packageName;
+    if (!rootPackage) {
+        return '';
+    }
+    return `try { const __nsRecord = globalThis.__NS_RECORD_MODULE_PROVENANCE__; if (typeof __nsRecord === 'function') { __nsRecord(${JSON.stringify(rootPackage)}, ${JSON.stringify({ kind: 'http-esm', specifier: packageSpecifier, url: sourceId, via })}); } } catch {}\n`;
+}
+function shouldRemapImport(spec) {
+    if (!spec || typeof spec !== 'string')
+        return false;
+    if (VENDOR_PACKAGES.test(spec))
+        return false;
+    if (isNativeScriptCoreModule(spec))
+        return false;
+    if (isNativeScriptPluginModule(spec))
+        return false;
+    if (resolveVendorFromCandidate(spec))
+        return false;
+    if (spec.startsWith('~/'))
+        return false;
+    if (SKIP_PATTERNS.test(spec))
+        return false;
+    if (!spec.startsWith('/') && !spec.startsWith('./') && !spec.startsWith('../')) {
+        return false;
+    }
+    return true;
+}
+function removeNamedImports(code, names) {
+    const regex = /^(\s*import\s*\{)([^}]*)(\}\s*from\s*['"][^'"]+['"];?)/gm;
+    return code.replace(regex, (_m, p1, specList, p3) => {
+        const srcMatch = /from\s*['"]\s*([^'"\s]+)\s*['"]/i.exec(_m);
+        const src = (srcMatch?.[1] || '').toLowerCase();
+        const isVueSource = /^(?:vue|nativescript-vue)(?:\b|\/)/i.test(src);
+        if (!isVueSource) {
+            return _m;
+        }
+        const remaining = specList
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean)
+            .filter((entry) => {
+            const base = entry.split(/\s+as\s+/i)[0].trim();
+            return !names.includes(base);
+        });
+        if (!remaining.length)
+            return '';
+        return `${p1} ${remaining.join(', ')} ${p3}`;
+    });
+}
+function normalizeImportPath(spec, importerDir) {
+    if (!spec)
+        return null;
+    let key;
+    if (spec.startsWith('/')) {
+        key = spec;
+    }
+    else if (spec.startsWith('./') || spec.startsWith('../')) {
+        key = path.posix.normalize(path.posix.join(importerDir, spec));
+        if (!key.startsWith('/')) {
+            key = `/${key}`;
+        }
+    }
+    else {
+        key = spec;
+    }
+    return key.replace(PAT.QUERY_PATTERN, '');
+}
+function findDependencyFileName(depFileMap, key) {
+    const variants = new Set();
+    const base = key.replace(PAT.QUERY_PATTERN, '');
+    variants.add(base);
+    const normalized = path.posix.normalize(base);
+    variants.add(normalized);
+    const withSlash = normalized.startsWith('/') ? normalized : `/${normalized}`;
+    variants.add(withSlash);
+    for (const variant of Array.from(variants)) {
+        if (variant.endsWith('.js')) {
+            variants.add(variant.replace(/\.js$/i, '.mjs'));
+        }
+        else if (variant.endsWith('.mjs')) {
+            variants.add(variant.replace(/\.mjs$/i, '.js'));
+        }
+    }
+    for (const variant of variants) {
+        const value = depFileMap.get(variant);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function isRuntimePluginRootEntrySpecifier(specifier, projectRoot) {
+    if (!specifier) {
+        return false;
+    }
+    const cleaned = specifier.replace(PAT.QUERY_PATTERN, '');
+    const normalized = normalizeNodeModulesSpecifier(cleaned) || cleaned.replace(/^\/+/, '');
+    if (!normalized) {
+        return false;
+    }
+    const { packageName, subpath } = resolveNodeModulesPackageBoundary(normalized, projectRoot);
+    if (!packageName || !isLikelyNativeScriptRuntimePluginSpecifier(packageName, projectRoot)) {
+        return false;
+    }
+    if (!subpath) {
+        return true;
+    }
+    if (subpath.includes('/')) {
+        return false;
+    }
+    const pkgBaseName = packageName.split('/').pop() || '';
+    const withoutExt = /(?:\.(?:ios|android|visionos))?\.(?:ts|tsx|js|jsx|mjs|mts|cts)$/i.test(subpath) ? subpath.replace(/\.[^.]+$/, '') : subpath;
+    const withoutPlatform = withoutExt.replace(/\.(ios|android|visionos)$/i, '');
+    return withoutPlatform === 'index' || withoutPlatform === pkgBaseName;
+}
+function collectMixedRuntimePluginHttpRootPackages(code, projectRoot) {
+    const nonRootSubpathPackages = new Set();
+    const rootEntryPackages = new Set();
+    const visitSpecifier = (rawSpecifier) => {
+        if (!rawSpecifier) {
+            return;
+        }
+        const specifier = normalizeNativeScriptCoreSpecifier(rawSpecifier).replace(PAT.QUERY_PATTERN, '');
+        if (!specifier) {
+            return;
+        }
+        if (/^https?:\/\//.test(specifier) || specifier.startsWith('/ns/')) {
+            return;
+        }
+        if (/^(?:\.|\/)/.test(specifier) && !specifier.includes('/node_modules/')) {
+            return;
+        }
+        const normalized = normalizeNodeModulesSpecifier(specifier) || specifier.replace(/^\/+/, '');
+        if (!normalized) {
+            return;
+        }
+        const { packageName } = resolveNodeModulesPackageBoundary(normalized, projectRoot);
+        if (!packageName || !isLikelyNativeScriptRuntimePluginSpecifier(packageName, projectRoot)) {
+            return;
+        }
+        if (isRuntimePluginRootEntrySpecifier(normalized, projectRoot)) {
+            rootEntryPackages.add(packageName);
+            return;
+        }
+        nonRootSubpathPackages.add(packageName);
+    };
+    for (const pattern of [PAT.IMPORT_PATTERN_1, PAT.IMPORT_PATTERN_2, PAT.IMPORT_PATTERN_3, PAT.IMPORT_PATTERN_SIDE_EFFECT]) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(code)) !== null) {
+            visitSpecifier(match[2]);
+        }
+    }
+    return new Set(Array.from(nonRootSubpathPackages).filter((packageName) => rootEntryPackages.has(packageName)));
+}
+// Application import helpers
+/**
+ * Check if a path is an application module (not node_modules, not vendor, not relative)
+ * This is generic and works for ANY project structure.
+ *
+ * Examples of application imports: /core/v4/store.ts, /src/utils/helper.ts, /custom/module.ts
+ * Examples of NON-application imports: node_modules/..., ~/vendor.mjs, ./relative.ts, ../parent.ts
+ */
+function isApplicationImport(importPath) {
+    if (!importPath.startsWith('/')) {
+        return false; // Relative paths (./..., ../...) are not application imports
+    }
+    // Exclude node_modules and special paths
+    if (importPath.includes('node_modules') || importPath.startsWith('/@') || importPath.startsWith('~/')) {
+        return false;
+    }
+    return true;
+}
+function stripToProjectRelative(importPath, projectRoot) {
+    if (!importPath) {
+        return '';
+    }
+    let normalized = importPath.replace(/\\/g, '/');
+    normalized = normalized.replace(/^\/?@fs\//, '/');
+    if (normalized.startsWith('file://')) {
+        normalized = normalized.replace(/^file:\/\//, '/');
+    }
+    const documentsMarker = '/Documents/';
+    const documentsIndex = normalized.indexOf(documentsMarker);
+    if (documentsIndex !== -1) {
+        return normalized.substring(documentsIndex + documentsMarker.length);
+    }
+    if (projectRoot) {
+        const normalizedRoot = projectRoot.replace(/\\/g, '/').replace(/\/+$/, '');
+        const rootIndex = normalized.indexOf(normalizedRoot);
+        if (rootIndex !== -1) {
+            const sliced = normalized.substring(rootIndex + normalizedRoot.length);
+            return sliced.replace(/^\/+/, '');
+        }
+    }
+    return normalized.replace(/^\/+/, '');
+}
+/**
+ * Convert absolute application import to relative .mjs path for Documents folder
+ * /core/v4/store.ts → ./core/v4/store.mjs
+ */
+function getProjectRelativeImportPath(importPath, projectRoot) {
+    if (!importPath) {
+        return null;
+    }
+    let normalized = importPath.replace(PAT.QUERY_PATTERN, '');
+    normalized = normalized.replace(/\\/g, '/');
+    if (normalized.startsWith('file://')) {
+        normalized = normalized.replace(/^file:\/\//, '/');
+    }
+    const documentsMarker = '/Documents/';
+    const documentsIndex = normalized.indexOf(documentsMarker);
+    if (documentsIndex !== -1) {
+        normalized = normalized.substring(documentsIndex + documentsMarker.length);
+    }
+    else if (projectRoot) {
+        const normalizedRoot = projectRoot.replace(/\\/g, '/').replace(/\/+$/, '');
+        const rootIndex = normalized.indexOf(normalizedRoot);
+        if (rootIndex !== -1) {
+            normalized = normalized.substring(rootIndex + normalizedRoot.length);
+        }
+    }
+    normalized = normalized.replace(/^\/+/, '');
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.startsWith('dep-')) {
+        return null;
+    }
+    if (normalized.startsWith('sfc-')) {
+        return null;
+    }
+    normalized = path.posix.normalize(normalized);
+    if (!normalized) {
+        return null;
+    }
+    normalized = normalized.replace(/\.(ts|js|tsx|jsx|mjs|mts|cts)$/i, '.mjs');
+    if (!normalized.endsWith('.mjs')) {
+        normalized = `${normalized}.mjs`;
+    }
+    return normalized.replace(/^\/+/, '');
+}
+function toAppModuleBaseId(importPath, projectRoot) {
+    const projectRelative = getProjectRelativeImportPath(importPath, projectRoot);
+    if (!projectRelative) {
+        return null;
+    }
+    const base = projectRelative.replace(/\.mjs$/i, '');
+    return `/${base}`;
+}
+function toNodeModulesHttpModuleId(importPath) {
+    const nodeModulesSpecifier = normalizeNodeModulesSpecifier(importPath);
+    if (!nodeModulesSpecifier) {
+        return null;
+    }
+    return `/ns/m/node_modules/${nodeModulesSpecifier}`;
+}
+export { rewriteVitePrebundleImportsForDevice, buildNodeModuleProvenancePrelude, shouldRemapImport, removeNamedImports, normalizeImportPath, findDependencyFileName, collectMixedRuntimePluginHttpRootPackages, isApplicationImport, stripToProjectRelative, getProjectRelativeImportPath, toAppModuleBaseId, toNodeModulesHttpModuleId };
+//# sourceMappingURL=device-transform-helpers.js.map

package/hmr/server/device-transform-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-transform-helpers.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/device-transform-helpers.ts"],"names":[],"mappings":"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"}

package/hmr/server/framework-strategy.d.ts

@@ -1,5 +1,6 @@
-import type { ViteDevServer } from 'vite';
+import type { HmrContext, ViteDevServer } from 'vite';
 import type { WebSocketServer } from 'ws';
+import type { NsHotUpdateContext } from './websocket-hot-update.js';
 export interface FrameworkProcessFileContext {
     filePath: string;
     server: ViteDevServer;
@@ -39,29 +40,125 @@ export interface FrameworkRegistryContext {
 export interface FrameworkCleanContext {
     code: string;
 }
+/**
+ * Inputs for {@link FrameworkServerStrategy.rewriteServedModule}, mirroring the
+ * arguments the `/ns/m` served-module pipeline passes to `rewriteImports` /
+ * `prepareAngularEntryForDevice` today (the angular/else fork in
+ * `websocket-ns-m.ts`).
+ */
+export interface FrameworkServedModuleContext {
+    /** Resolved module specifier / URL being served (`resolvedCandidate || spec`). */
+    moduleId: string;
+    sfcFileMap: Map<string, string>;
+    depFileMap: Map<string, string>;
+    projectRoot: string;
+    serverOrigin: string;
+    verbose: boolean;
+}
+/**
+ * Inputs for {@link FrameworkServerStrategy.registerRoutes}. A framework that
+ * owns dev-only HTTP endpoints (e.g. Vue's `/ns/sfc*`) registers them here;
+ * frameworks without extra endpoints leave the hook undefined (no-op default).
+ *
+ * Carries everything Vue's `registerSfcHandlers` needs (its
+ * `RegisterSfcHandlersOptions` shape): the dev server, plugin state
+ * (`sfcFileMap`/`depFileMap`/`appVirtualWithSlash`), the live graph-version
+ * accessor, and the active strategy. `wss` is included for parity with the
+ * other route registrars (the SFC handlers don't consult it today).
+ */
+export interface FrameworkRouteContext {
+    server: ViteDevServer;
+    wss: WebSocketServer | null;
+    sfcFileMap: Map<string, string>;
+    depFileMap: Map<string, string>;
+    verbose: boolean;
+    appVirtualWithSlash: string;
+    getGraphVersion(): number;
+    getStrategy(): FrameworkServerStrategy;
+}
 export interface FrameworkServerStrategy {
     readonly flavor: string;
     matchesFile(id: string): boolean;
+    /** Framework-specific pre-clean phase (remove virtual style imports, etc.). */
+    preClean?(code: string): string;
+    /** Rewrite framework runtime imports to vendor bundle. */
+    rewriteFrameworkImports?(code: string): string;
+    /** Framework-specific post-clean phase (strip HMR helpers, etc.). */
+    postClean?(code: string): string;
+    /** Ensure framework-specific HTTP endpoints/imports are versioned for cache-busting. */
+    ensureVersionedImports?(code: string, origin: string, version: number): string;
+    /** Optional vendor rewrite hook (e.g. map framework helper imports to vendor). */
+    rewriteVendorSpec?(code: string, origin: string, version: number): string;
     /**
-     * Framework-specific pre-clean phase (remove virtual style imports, etc.).
+     * Full per-framework `handleHotUpdate` implementation. Every flavor owns one:
+     * the WebSocket plugin's `handleHotUpdate` Vite hook calls it directly, and
+     * the implementation runs the shared {@link NsHotUpdateContext}-driven
+     * `runHotUpdatePrologue` followed by its own framework tail.
      */
-    preClean(code: string): string;
+    handleHotUpdate?(ctx: HmrContext, deps: NsHotUpdateContext): Promise<HmrContext['modules'] | void>;
     /**
-     * Rewrite framework runtime imports to vendor bundle.
+     * When `true`, the per-module graph delta is NOT broadcast inline during a
+     * hot update (the framework drives its own re-fetch/patch instead — Angular
+     * & Solid). Defaults to `false` → delta is broadcast (today's TS/Vue path).
      */
-    rewriteFrameworkImports(code: string): string;
+    readonly deferDeltaBroadcast?: boolean;
     /**
-     * Framework-specific post-clean phase (strip HMR helpers, etc.).
+     * When this returns `true` for the changed file, the shared prologue SKIPS
+     * its default module-graph delta upsert — the framework's own
+     * `handleHotUpdate` tail re-queries the graph and drives the update itself
+     * (Angular HTML templates: Analog's in-place swap or the NS reboot path).
+     * Defaults to no-skip (the prologue always upserts).
      */
-    postClean(code: string): string;
+    skipDefaultGraphUpdate?(file: string): boolean;
     /**
-     * Ensure framework-specific HTTP endpoints/imports are versioned for cache-busting.
+     * When `true`, the shared prologue does NOT broadcast `ns:css-updates` for a
+     * component-scoped style edit (a non-global `.css`) — the framework's own
+     * `handleHotUpdate` drives the in-place component update instead. For
+     * Angular with Analog `liveReload` active this is essential: Analog emits
+     * `angular:component-update` only while the css's `?direct` module is absent
+     * from the graph, and the prologue's broadcast makes the device fetch
+     * `…?direct=1`, which creates that module and flips Analog to its
+     * (NativeScript-inert) Vite css-update branch on every subsequent edit. The
+     * global app-entry CSS path is unaffected (it is not component-scoped).
+     * Defaults to `false` (every flavor keeps the component-style broadcast).
      */
-    ensureVersionedImports(code: string, origin: string, version: number): string;
+    ownsComponentStyleHmr?(server: ViteDevServer): boolean;
     /**
-     * Optional vendor rewrite hook (e.g. map framework helper imports to vendor).
+     * Override the `/ns/m` served-module import rewrite. Defaults to the shared
+     * `rewriteImports` (today's non-Angular path); Angular overrides with its
+     * entry-preparation pass. Returns the rewritten code.
      */
-    rewriteVendorSpec?(code: string, origin: string, version: number): string;
+    rewriteServedModule?(code: string, ctx: FrameworkServedModuleContext): string;
+    /**
+     * Patch a served `node_modules` module before device delivery (e.g. Solid's
+     * inline `@solid-refresh` patch). Defaults to identity (code unchanged).
+     * `verbose` mirrors the `/ns/m` plugin's `verbose` option and gates the
+     * server-side diagnostics the inline patch emitted today (the device process
+     * sets `globalThis.__NS_ENV_VERBOSE__`, but the Node server never does).
+     */
+    transformNodeModule?(code: string, moduleId: string, verbose?: boolean): string;
+    /**
+     * Framework SFC post-processing (Vue). Defaults to identity. Mirrors the
+     * `processSfcCode` helper currently injected via the registry context.
+     */
+    processSfcCode?(code: string): string;
+    /**
+     * Register framework-owned dev HTTP endpoints (Vue: `/ns/sfc*`). Defaults to
+     * no-op for frameworks without extra routes.
+     */
+    registerRoutes?(ctx: FrameworkRouteContext): void;
+    /**
+     * Extra import-map entries for this framework (e.g. Vue → `vue` /
+     * `nativescript-vue`; Solid → `solid-js`). Defaults to none. Replaces the
+     * `addFrameworkEntries` switch in `import-map.ts`.
+     */
+    importMapEntries?(origin: string): Record<string, string>;
+    /**
+     * Extra volatile URL patterns the device runtime must always re-fetch (Vue →
+     * `/@ns/sfc/`, `/@ns/asm/`; Angular → `/@ns/asm/`). Defaults to none.
+     * Replaces the framework arm of `getVolatilePatterns`.
+     */
+    volatilePatterns?(): string[];
     processFile(ctx: FrameworkProcessFileContext): Promise<void>;
     buildRegistry(ctx: FrameworkRegistryContext): Promise<void>;
 }

package/hmr/server/hmr-module-graph.d.ts

@@ -0,0 +1,37 @@
+import type { WebSocket, WebSocketServer } from 'ws';
+import type { FrameworkServerStrategy } from './framework-strategy.js';
+export interface GraphModule {
+    id: string;
+    deps: string[];
+    hash: string;
+}
+export interface UpsertOptions {
+    emitDeltaOnInsert?: boolean;
+    broadcastDelta?: boolean;
+    bumpVersion?: boolean;
+}
+export interface HmrModuleGraphDeps {
+    verbose: boolean;
+    strategy: FrameworkServerStrategy;
+    getWss: () => WebSocketServer | null;
+    getPluginRoot: () => string | undefined;
+}
+export declare class HmrModuleGraph {
+    private readonly deps;
+    readonly modules: Map<string, GraphModule>;
+    private readonly txnBatches;
+    private _version;
+    constructor(deps: HmrModuleGraphDeps);
+    get version(): number;
+    get size(): number;
+    get(id: string): GraphModule | undefined;
+    getTxnBatch(version: number): string[];
+    computeHash(content: string): string;
+    normalizeGraphId(raw: string): string;
+    computeTxnOrderForChanged(changedIds: string[]): string[];
+    private fullGraphPayload;
+    emitFullGraph(ws: WebSocket): void;
+    emitDelta(changed: GraphModule[], removed: string[]): void;
+    upsert(rawId: string, code: string, deps: string[], options?: UpsertOptions): GraphModule | undefined;
+    remove(id: string): void;
+}