@nativescript/vite 8.0.0-alpha.3 → 8.0.0-alpha.30

package/hmr/server/ns-core-cjs-shape.js

@@ -0,0 +1,271 @@
+/**
+ * CJS/ESM interop shape.
+ *
+ * PROBLEM
+ * -------
+ * ESM Module Namespace Objects (ECMA §9.4.6) have [[Prototype]] = null.
+ * They do NOT inherit Object.prototype — no `hasOwnProperty`, no `toString`,
+ * no `isPrototypeOf`. CJS consumers (most notably zone.js's `patchMethod`)
+ * assume their require() result is a plain object that has those methods:
+ *
+ *     let proto = target;
+ *     while (proto && !proto.hasOwnProperty(name)) // ← crashes on null-proto
+ *       proto = Object.getPrototypeOf(proto);
+ *
+ * `@nativescript/core/index.js` re-exports several sub-modules as namespaces:
+ *
+ *     export * as Utils from './utils';
+ *     export * as Http from './http';
+ *     export * as Connectivity from './connectivity';
+ *     export * as ApplicationSettings from './application-settings';
+ *
+ * When bundle.mjs does `import { Utils } from '@nativescript/core'`, `Utils`
+ * binds to that null-proto sub-namespace. zone.js then does
+ * `patchMethod(Utils, 'mainThreadify', …)` and crashes.
+ *
+ * WHY globalThis.require shims ALONE DON'T FIX THIS
+ * -------------------------------------------------
+ * ESM imports never pass through `globalThis.require`. They go through the
+ * host's ESM linker (V8 on iOS). Shimming `require` only intercepts the CJS
+ * path (vendor packages that use `require('@nativescript/core')`); direct
+ * ESM imports of `Utils` still see the raw null-proto namespace.
+ *
+ * THE FIX
+ * -------
+ * Rewrite `export * as X from 'Y'` at the /ns/core bridge response level:
+ *
+ *     // before
+ *     export * as Utils from './utils';
+ *
+ *     // after
+ *     import * as __ns_re_Utils__ from './utils';
+ *     export const Utils = __NS_CJS_SHAPE__(__ns_re_Utils__);
+ *
+ * Now `Utils` is a plain Object (inherits Object.prototype). Zone.js's
+ * `patchMethod(Utils, ...)` succeeds. The shape function is recursive —
+ * nested namespaces get the same treatment — and identity-preserving
+ * (WeakMap-cached) so mutations stick across lookups.
+ *
+ * WHY THE SHAPE INSTALL MUST RUN IN MODULE BODY (NOT FOOTER)
+ * ---------------------------------------------------------
+ * `export const Utils = __NS_CJS_SHAPE__(__ns_re_Utils__)` is body code. It
+ * executes during module evaluation, BEFORE the registration footer. So the
+ * shape function must be installed as a body-level statement that runs
+ * before the rewritten body — we can't rely on the footer's install.
+ *
+ * Each served /ns/core module independently installs the shape function via
+ * an idempotent `|| (globalThis.__NS_CJS_SHAPE__ = ...)` assignment. The
+ * first module to evaluate wins; subsequent evaluations are no-ops. This
+ * also handles dependency-before-importer order (depth-first ESM eval):
+ * `/ns/core/utils` evaluates before `/ns/core` main, so the shape helper
+ * is in place whenever any body needs it.
+ */
+/**
+ * Body-code statements that idempotently install `globalThis.__NS_CJS_SHAPE__`
+ * and `globalThis.__NS_CJS_SHAPE_CACHE__`. Must execute BEFORE any transformed
+ * `export const X = __NS_CJS_SHAPE__(...)` statement in the same module.
+ *
+ * Properties:
+ *   - Recursive: traverses nested namespaces so `Utils.Something` is also
+ *     a plain Object (if that sub-namespace is itself null-proto).
+ *   - Identity-preserving: WeakMap keyed on the underlying ESM namespace.
+ *     zone.js mutates its patch target; a fresh copy per call would lose
+ *     mutations. Every lookup of the same namespace returns the same
+ *     shaped object.
+ *   - Cycle-safe: records the output in the cache BEFORE recursing into
+ *     children. Handles `core ↔ platform` style cycles.
+ *   - TDZ-safe: wraps each property read in try/catch. Some exports
+ *     (Angular zone.js with early-access patterns) are still in their
+ *     temporal dead zone when the namespace is first snapshotted. A thrown
+ *     property read is skipped rather than failing the whole shape.
+ */
+export function buildShapeInstallHeader() {
+    return [
+        `/* Invariant D: CJS/ESM interop shape installer */`,
+        `try { if (typeof globalThis !== 'undefined') {`,
+        `  const __nsShapeCache = globalThis.__NS_CJS_SHAPE_CACHE__ || (globalThis.__NS_CJS_SHAPE_CACHE__ = new WeakMap());`,
+        `  if (typeof globalThis.__NS_CJS_SHAPE__ !== 'function') {`,
+        `    globalThis.__NS_CJS_SHAPE__ = function __nsShape(obj) {`,
+        `      if (!obj || typeof obj !== 'object') return obj;`,
+        `      let isNsModule = false;`,
+        `      try { isNsModule = obj[Symbol.toStringTag] === 'Module'; } catch (e) {}`,
+        `      const proto = Object.getPrototypeOf(obj);`,
+        `      if (proto !== null && !isNsModule) return obj;`,
+        `      if (__nsShapeCache.has(obj)) return __nsShapeCache.get(obj);`,
+        `      const out = {};`,
+        `      __nsShapeCache.set(obj, out);`,
+        `      try {`,
+        `        const keys = Object.keys(obj);`,
+        `        for (let i = 0; i < keys.length; i++) {`,
+        `          const k = keys[i];`,
+        `          try { out[k] = __nsShape(obj[k]); } catch (e) { /* TDZ / unreadable */ }`,
+        `        }`,
+        `      } catch (e) {}`,
+        `      return out;`,
+        `    };`,
+        `  }`,
+        `} } catch (e) { console.warn('[ns-core] shape installer failed:', (e && e.message) || e); }`,
+    ].join('\n');
+}
+/**
+ * Rewrite namespace re-exports from CJS-incompatible ESM namespace form into
+ * shape-aware const exports. Handles the two forms Vite/esbuild may emit:
+ *
+ *   (1) Original ES2020 syntax preserved unchanged:
+ *       export * as X from 'Y';
+ *
+ *   (2) Transpiled form esbuild emits when targeting older ES:
+ *       import * as _foo from 'Y';
+ *       export { _foo as X };
+ *
+ * Both become:
+ *   import * as __ns_re_X__ from 'Y';
+ *   export const X = __NS_CJS_SHAPE__(__ns_re_X__);
+ *
+ * Notes on the transform:
+ *   - The internal binding uses a derived name (`__ns_re_<X>__`) so
+ *     collisions with user bindings are extremely unlikely. Core doesn't
+ *     declare identifiers matching that shape.
+ *   - `__NS_CJS_SHAPE__` is read from globalThis with a defensive fallback
+ *     (identity function) in case installation failed or runs in an
+ *     environment where it hasn't been initialized yet. This makes the
+ *     transform safe to apply to modules that don't always go through the
+ *     /ns/core handler's headers.
+ *   - We do NOT shape `export *` (star re-exports without alias). Those
+ *     spread individual named exports — they don't create a nested
+ *     namespace and aren't affected by the null-proto issue.
+ *   - We do NOT shape `export { x } from 'y'` forms. Those copy individual
+ *     named exports directly; the consumer never sees the namespace.
+ *
+ * The regex is intentionally precise. It matches only the `export * as X from
+ * 'Y'` syntactic form (and its transpiled equivalent) — no accidental matches
+ * in string literals or comments because those can't start a top-level
+ * statement with `export`.
+ */
+export function rewriteNamespaceReExportsForShape(code) {
+    const shapeExpr = `(typeof globalThis.__NS_CJS_SHAPE__ === 'function' ? globalThis.__NS_CJS_SHAPE__ : function (x) { return x; })`;
+    // Form (1): export * as X from 'Y';  (ES2020 aggregate re-export)
+    let out = code.replace(/(^|\n)(\s*)export\s+\*\s+as\s+([A-Za-z_$][\w$]*)\s+from\s+(['"`])([^'"`\n]+)\4\s*;?/g, (_match, prefix, indent, name, quote, spec) => {
+        const internal = `__ns_re_${name}__`;
+        return `${prefix}${indent}import * as ${internal} from ${quote}${spec}${quote};\n${indent}export const ${name} = ${shapeExpr}(${internal});`;
+    });
+    // Form (2): import * as _x from 'Y'; export { _x as X };
+    // This pattern appears when esbuild targets older ES. We detect the pair
+    // by matching the import and its paired export on the same or adjacent
+    // lines. Rather than try to join two regex passes, we transform the
+    // `export { _x as X }` branch by replacing the `_x` in the export with a
+    // shape-wrapped const. Keeping the import intact is safe because the
+    // local binding is still needed for the shape call.
+    out = out.replace(/export\s*\{\s*([A-Za-z_$][\w$]*)\s+as\s+([A-Za-z_$][\w$]*)\s*\}\s*;?/g, (match, localName, exportName) => {
+        // Only transform if the local name looks like an esbuild-generated
+        // namespace binding (leading underscore) AND the export name is a
+        // PascalCase identifier. This avoids touching user re-exports.
+        if (!/^_/.test(localName))
+            return match;
+        if (!/^[A-Z]/.test(exportName))
+            return match;
+        return `export const ${exportName} = ${shapeExpr}(${localName});`;
+    });
+    return out;
+}
+/**
+ * Convenience: returns true if the given code appears to contain at least one
+ * namespace re-export that would benefit from the shape transform. Used to
+ * skip the regex replace for modules that don't need it (keeps the response
+ * identical for most submodules, which just have plain `export * from` or
+ * named exports).
+ */
+export function hasNamespaceReExport(code) {
+    return /export\s+\*\s+as\s+[A-Za-z_$][\w$]*\s+from\s+['"`]/.test(code);
+}
+/**
+ * Default-export bridge footer.
+ *
+ * BACKGROUND
+ * ----------
+ * Upstream consumer rewrites in the /ns/m handler convert
+ * `import { X } from '@nativescript/core'` into
+ * `import __ns_core_ns from '/ns/core'; const { X } = __ns_core_ns;`
+ * — a DEFAULT import followed by destructuring. The inline comment on that
+ * rewrite says explicitly: "This makes `import { Frame } from
+ * '@nativescript/core'` work even if the bridge provides only a default
+ * export."
+ *
+ * The original `@nativescript/core/index.js` has no `export default` — all
+ * named exports. Without this footer, consumers of the transformed import
+ * fail at ESM link time:
+ *
+ *     SyntaxError: The requested module '/ns/core/<ver>' does not
+ *     provide an export named 'default'
+ *
+ * THE FIX
+ * -------
+ * Emit `export default __ns_core_self_ns__;` at the end of the served
+ * module body. `__ns_core_self_ns__` is the namespace import the server
+ * already emits at the top of every /ns/core response for self-
+ * registration purposes. ESM spec guarantees a module re-entering itself
+ * during evaluation returns the in-progress namespace — so no extra
+ * evaluation occurs, and the default binding receives an object whose
+ * properties are every named export of the same module.
+ *
+ * CONSUMER MATRIX AFTER THIS FIX
+ * ------------------------------
+ *   • `import X from '/ns/core'` (default)     → X = self namespace
+ *   • `import * as X from '/ns/core'`          → X = self namespace + X.default = self
+ *   • `import { X } from '/ns/core'` (named)   → individual named binding (untouched)
+ *   • `const { X } = <default-import>`         → destructure from self namespace
+ *   • `require('@nativescript/core')` (CJS)    → shaped self via registry
+ *
+ * SKIP CONDITIONS
+ * ---------------
+ * Returns empty string when the source already declares a default export
+ * (some deep subpaths do — e.g. a file that does `export default MyClass`
+ * would SyntaxError on a duplicate). The consumer rewrite is also gated
+ * on `isDeepCoreSubpath`, so those paths don't normally hit the default-
+ * import pattern anyway.
+ *
+ * WHY THE DEFAULT ISN'T SHAPED
+ * ----------------------------
+ * The default is the raw null-proto MNO. This is intentional:
+ *
+ *   1. All current default-import consumers either destructure or do
+ *      property access. Neither requires Object.prototype in the chain.
+ *   2. Shaping the default inside the module body would require calling
+ *      __NS_CJS_SHAPE__ on a namespace whose own `default` slot is still
+ *      being initialized — temporal dead zone hazard.
+ *   3. CJS consumers that need `.hasOwnProperty` go through the registry
+ *      (shaped at registration), not through the default import.
+ *
+ * If a future consumer surfaces that calls `.hasOwnProperty` on the
+ * default, we can revisit. The current rule-of-least-surprise is:
+ * shape at the CJS boundary, not at the ESM boundary.
+ */
+export function buildDefaultExportFooter(rewrittenCode) {
+    if (hasExistingDefaultExport(rewrittenCode))
+        return '';
+    return ['/* Default-export bridge for /ns/core consumers */', 'export default __ns_core_self_ns__;'].join('\n');
+}
+/**
+ * Detects whether a module body already declares a default export in any of
+ * the syntactic forms the ESM spec allows. Mirrors the logic in
+ * `websocket-core-bridge.ts:hasModuleDefaultExport` — kept here so the
+ * default-export bridge helper is self-contained and unit-testable.
+ *
+ * Handles:
+ *   - `export default <expr>;`
+ *   - `export default function|class ...`
+ *   - `export { x as default };`
+ *   - `export { default };`        (implicit `default as default`)
+ *   - `export { default as default };`
+ *   - `export { foo, default };`
+ */
+export function hasExistingDefaultExport(code) {
+    if (!code || typeof code !== 'string')
+        return false;
+    if (/\bexport\s+default\b/.test(code))
+        return true;
+    if (/\bexport\s*\{[^}]*\bdefault\b[^}]*\}/.test(code))
+        return true;
+    return false;
+}
+//# sourceMappingURL=ns-core-cjs-shape.js.map

package/hmr/server/ns-core-cjs-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-core-cjs-shape.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/ns-core-cjs-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,oDAAoD;QACpD,gDAAgD;QAChD,oHAAoH;QACpH,4DAA4D;QAC5D,6DAA6D;QAC7D,wDAAwD;QACxD,+BAA+B;QAC/B,+EAA+E;QAC/E,iDAAiD;QACjD,sDAAsD;QACtD,oEAAoE;QACpE,uBAAuB;QACvB,qCAAqC;QACrC,aAAa;QACb,wCAAwC;QACxC,iDAAiD;QACjD,8BAA8B;QAC9B,oFAAoF;QACpF,WAAW;QACX,sBAAsB;QACtB,mBAAmB;QACnB,QAAQ;QACR,KAAK;QACL,6FAA6F;KAC7F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAY;IAC7D,MAAM,SAAS,GAAG,gHAAgH,CAAC;IAEnI,kEAAkE;IAClE,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,sFAAsF,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;QACpM,MAAM,QAAQ,GAAG,WAAW,IAAI,IAAI,CAAC;QACrC,OAAO,GAAG,MAAM,GAAG,MAAM,eAAe,QAAQ,SAAS,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,MAAM,gBAAgB,IAAI,MAAM,SAAS,IAAI,QAAQ,IAAI,CAAC;IAC9I,CAAC,CAAC,CAAC;IAEH,yDAAyD;IACzD,yEAAyE;IACzE,uEAAuE;IACvE,oEAAoE;IACpE,yEAAyE;IACzE,qEAAqE;IACrE,oDAAoD;IACpD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,uEAAuE,EAAE,CAAC,KAAK,EAAE,SAAiB,EAAE,UAAkB,EAAE,EAAE;QAC3I,mEAAmE;QACnE,kEAAkE;QAClE,+DAA+D;QAC/D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,OAAO,gBAAgB,UAAU,MAAM,SAAS,IAAI,SAAS,IAAI,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAChD,OAAO,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,UAAU,wBAAwB,CAAC,aAAqB;IAC7D,IAAI,wBAAwB,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAC;IACvD,OAAO,CAAC,oDAAoD,EAAE,qCAAqC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACpD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,KAAK,CAAC;AACd,CAAC"}

package/hmr/server/ns-rt-bridge.d.ts

@@ -0,0 +1,51 @@
+export interface NsRtBridgeOptions {
+    /** Version segment from `/ns/rt/<ver>`. Retained for the URL dispatcher; the bridge body intentionally ignores it. */
+    rtVer: string;
+    /** Prologue installed verbatim before the bridge body (typically the require URL guard). */
+    requireGuardSnippet: string;
+    /**
+     * The discovered ESM export names of the underlying vendor package
+     * (`nativescript-vue`, including its `@vue/runtime-core` re-export
+     * chain). Each name becomes `export const <name> = (__ensure().<name>);` —
+     * a single canonical specifier (`/ns/rt`) forwards *every* symbol the
+     * vendor publishes.
+     *
+     * Required: discovery is the only source of truth. There is no hand-curated
+     * fallback — if discovery cannot see the package, the bridge serves no
+     * passthroughs and the call site is expected to surface that as a config
+     * error rather than silently degrade.
+     */
+    vendorExports: Iterable<string>;
+}
+/**
+ * Build the `/ns/rt` runtime bridge module text.
+ *
+ * Single-realm policy: every named export the vendor package publishes
+ * appears as `export const X = (__ensure().X);` — a constant binding, not a
+ * function wrapper. Constant bindings preserve identity for Vue's Symbol
+ * markers (`Fragment`, `Teleport`, …) AND work transparently for functions
+ * (`ref`, `createApp`, …) since the user code calls the underlying value
+ * directly. Calling `__ensure()` at module evaluation time is safe because
+ * the vendor bundle is registered earlier in the boot graph (vendor.mjs →
+ * `__nsVendorRegistry`), and the bridge resolves the same `nativescript-vue`
+ * record everyone else uses.
+ *
+ * HMR-specific shims (`$navigateTo`, `$navigateBack`, `$showModal`) and the
+ * Vite client polyfill (`vite__injectQuery`) are emitted as overrides that
+ * replace the would-be passthrough — those exports route through the HMR
+ * navigator instead of the vendor's native version, so the bridge must
+ * provide the override, not the discovered original.
+ */
+export declare function buildNsRtBridgeModule(options: NsRtBridgeOptions): string;
+/**
+ * Resolve the set of names the bridge should re-export for `nativescript-vue`
+ * given a project root. Static discovery via `enumeratePackageExports` is the
+ * only source — there is no curated fallback. If `nativescript-vue` is not
+ * resolvable from `projectRoot`, the returned set is empty and the bridge
+ * built from it will not emit passthroughs; the caller should treat that as
+ * the misconfiguration it is rather than mask it with a stale baseline.
+ *
+ * Caching lives inside `enumeratePackageExports`, so repeated calls in a dev
+ * session are effectively free.
+ */
+export declare function discoverNsvBridgeExports(projectRoot: string): Set<string>;

package/hmr/server/ns-rt-bridge.js

@@ -0,0 +1,131 @@
+import { enumeratePackageExports } from '../helpers/package-exports.js';
+// Exports the bridge replaces with HMR-routed implementations — discovery
+// must not emit a plain passthrough for these names or the override would be
+// shadowed and navigation would silently fall back to the vendor's native
+// version (which doesn't know about the HMR app navigator).
+const NSV_SHIM_OVERRIDES = new Set(['$navigateTo', '$navigateBack', '$showModal', 'vite__injectQuery']);
+// Bridge-internal identifiers that would clash with the emitted preamble if
+// the vendor package happens to publish a colliding name.
+const RESERVED_BRIDGE_LOCALS = new Set(['__realm', '__cached_rt', '__cached_vm', '__ensure', '__get', 'default']);
+const IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/**
+ * Build the `/ns/rt` runtime bridge module text.
+ *
+ * Single-realm policy: every named export the vendor package publishes
+ * appears as `export const X = (__ensure().X);` — a constant binding, not a
+ * function wrapper. Constant bindings preserve identity for Vue's Symbol
+ * markers (`Fragment`, `Teleport`, …) AND work transparently for functions
+ * (`ref`, `createApp`, …) since the user code calls the underlying value
+ * directly. Calling `__ensure()` at module evaluation time is safe because
+ * the vendor bundle is registered earlier in the boot graph (vendor.mjs →
+ * `__nsVendorRegistry`), and the bridge resolves the same `nativescript-vue`
+ * record everyone else uses.
+ *
+ * HMR-specific shims (`$navigateTo`, `$navigateBack`, `$showModal`) and the
+ * Vite client polyfill (`vite__injectQuery`) are emitted as overrides that
+ * replace the would-be passthrough — those exports route through the HMR
+ * navigator instead of the vendor's native version, so the bridge must
+ * provide the override, not the discovered original.
+ */
+export function buildNsRtBridgeModule(options) {
+    // Sort for stable output — useful for diffing the served bridge across requests.
+    const passthrough = new Set();
+    for (const name of options.vendorExports) {
+        if (typeof name === 'string' && IDENT_RE.test(name) && !NSV_SHIM_OVERRIDES.has(name) && !RESERVED_BRIDGE_LOCALS.has(name)) {
+            passthrough.add(name);
+        }
+    }
+    const passthroughNames = Array.from(passthrough).sort();
+    const passthroughExports = passthroughNames.map((n) => `export const ${n} = (__ensure().${n});`).join('\n');
+    const defaultListing = passthroughNames.concat(['$navigateTo', '$navigateBack', '$showModal', 'vite__injectQuery']).join(', ');
+    const code = `// [ns-rt][v2.4] NativeScript-Vue runtime bridge (module-scoped cache, no globals)\n` +
+        `// Single-realm policy: every export is a constant binding off the vendor module's\n` +
+        `// canonical instance, so app code, plugins, and the vendor bundle itself share one\n` +
+        `// module record. The set of exports below is derived from the package's static ESM\n` +
+        `// shape (see hmr/helpers/package-exports.ts), not a hand-curated list, so any symbol\n` +
+        `// the vendor publishes flows through automatically.\n` +
+        `const __origin = ((typeof globalThis !== 'undefined' && globalThis && globalThis.__NS_HTTP_ORIGIN__) || (new URL(import.meta.url)).origin);\n` +
+        // Use the canonical, unversioned `/ns/core` URL so this dynamic import
+        // shares an iOS HTTP-ESM module record (and therefore a single class-
+        // identity realm) with vendor `require('@nativescript/core')` lookups
+        // resolved via the runtime import map, plus every app-side import that
+        // goes through the core bridge. The `rtVer` is intentionally unused.
+        `let __ns_core_bridge = null; try { import(__origin + "/ns/core").then(m => { __ns_core_bridge = m; }).catch(() => {}); } catch {}\n` +
+        `const g = globalThis;\n` +
+        `const reg = (g.__nsVendorRegistry ||= new Map());\n` +
+        `const req = reg && reg.get ? (g.__nsVendorRequire || g.__nsRequire || g.require) : (g.__nsRequire || g.require);\n` +
+        `let __cached_rt = null;\n` +
+        `let __cached_vm = null;\n` +
+        `const __RT_REALM_TAG = (globalThis.__NS_RT_REALM__ ||= Math.random().toString(36).slice(2));\n` +
+        `try { if (!(globalThis.__NS_RT_ONCE__ && globalThis.__NS_RT_ONCE__.eval)) { (globalThis.__NS_RT_ONCE__ ||= {}).eval = true; if (globalThis.__NS_ENV_VERBOSE__) console.log('[ns-rt] evaluated', { rtRealm: __RT_REALM_TAG }); } } catch {}\n` +
+        `function __ensure(){\n` +
+        `  if (__cached_rt) return __cached_rt;\n` +
+        `  let vm = null;\n` +
+        `  try { vm = reg && reg.has && reg.has('nativescript-vue') ? reg.get('nativescript-vue') : (typeof req==='function' ? req('nativescript-vue') : null); } catch {}\n` +
+        `  if (!vm) { try { vm = reg && reg.has && reg.has('vue') ? reg.get('vue') : (typeof req==='function' ? req('vue') : null); } catch {} }\n` +
+        `  const rt = (vm && (vm.default ?? vm)) || {};\n` +
+        `  __cached_vm = vm;\n` +
+        `  __cached_rt = rt;\n` +
+        `  return rt;\n` +
+        `}\n` +
+        // Soft-globals for @nativescript/core when missing (dev-only safety).
+        // This stays even with the auto-derived passthrough because Frame /
+        // Page / Application aren't `nativescript-vue` exports — they're
+        // hoisted onto `globalThis` so the navigation shims (and any legacy
+        // `global.Frame.topmost()`-style call site inside the vendor bundle)
+        // see the same identities served by `/ns/core`.
+        `try {\n` +
+        `  const dev = typeof __DEV__ !== 'undefined' ? __DEV__ : true;\n` +
+        `  if (dev) {\n` +
+        `    const ns = (__ns_core_bridge && (__ns_core_bridge.__esModule && __ns_core_bridge.default ? __ns_core_bridge.default : (__ns_core_bridge.default || __ns_core_bridge))) || __ns_core_bridge || {};\n` +
+        `    if (ns) {\n` +
+        `      if (!g.Frame && ns.Frame) g.Frame = ns.Frame;\n` +
+        `      if (!g.Page && ns.Page) g.Page = ns.Page;\n` +
+        `      if (!g.Application && (ns.Application||ns.app||ns.application)) g.Application = (ns.Application||ns.app||ns.application);\n` +
+        `    }\n` +
+        `  }\n` +
+        `} catch {}\n` +
+        `export const __realm = __RT_REALM_TAG;\n` +
+        // Auto-emitted passthrough exports. Discovery-driven, sorted, dedupe'd.
+        passthroughExports +
+        `\n` +
+        // HMR-routed navigation helpers (replace the would-be passthroughs).
+        // These run through `globalThis.__nsNavigateUsingApp` etc. instead of
+        // the vendor's native navigation, so HMR can re-route navigation
+        // targets after module updates.
+        `export const $navigateTo = (...a) => { const vm = (__cached_vm || (void __ensure(), __cached_vm)); const rt = __ensure(); try { if (!(g && g.Frame)) { const ns = (__ns_core_bridge && (__ns_core_bridge.__esModule && __ns_core_bridge.default ? __ns_core_bridge.default : (__ns_core_bridge.default || __ns_core_bridge))) || __ns_core_bridge || {}; if (ns) { if (!g.Frame && ns.Frame) g.Frame = ns.Frame; if (!g.Page && ns.Page) g.Page = ns.Page; if (!g.Application && (ns.Application||ns.app||ns.application)) g.Application = (ns.Application||ns.app||ns.application); } } } catch {} try { const hmrRealm = (g && g.__NS_HMR_REALM__) || 'unknown'; const hasTop = !!(g && g.Frame && g.Frame.topmost && g.Frame.topmost()); const top = hasTop ? g.Frame.topmost() : null; const ctor = top && top.constructor && top.constructor.name; } catch {} if (g && typeof g.__nsNavigateUsingApp === 'function') { try { return g.__nsNavigateUsingApp(...a); } catch (e) { console.error('[ns-rt] $navigateTo app navigator error', e); throw e; } } console.error('[ns-rt] $navigateTo unavailable: app navigator missing'); throw new Error('$navigateTo unavailable: app navigator missing'); } ;\n` +
+        `export const $navigateBack = (...a) => { const vm = (__cached_vm || (void __ensure(), __cached_vm)); const rt = __ensure(); const impl = (vm && (vm.$navigateBack || (vm.default && vm.default.$navigateBack))) || (rt && (rt.$navigateBack || (rt.runtimeHelpers && rt.runtimeHelpers.navigateBack))); let res; try { const via = (impl && (impl === (vm && vm.$navigateBack) || impl === (vm && vm.default && vm.default.$navigateBack))) ? 'vm' : (impl ? 'rt' : 'none'); } catch {} try { if (typeof impl === 'function') res = impl(...a); } catch {} try { const top = (g && g.Frame && g.Frame.topmost && g.Frame.topmost()); if (!res && top && top.canGoBack && top.canGoBack()) { res = top.goBack(); } } catch {} try { const hook = g && (g.__NS_HMR_ON_NAVIGATE_BACK || g.__NS_HMR_ON_BACK || g.__nsAttemptBackRemount); if (typeof hook === 'function') hook(); } catch {} return res; }\n` +
+        `export const $showModal = (...a) => { const vm = (__cached_vm || (void __ensure(), __cached_vm)); const rt = __ensure(); const impl = (vm && (vm.$showModal || (vm.default && vm.default.$showModal))) || (rt && (rt.$showModal || (rt.runtimeHelpers && rt.runtimeHelpers.showModal))); try { if (typeof impl === 'function') return impl(...a); } catch (e) { } return undefined; }\n` +
+        // Vite client polyfill — see the comment in websocket.ts for full rationale.
+        `export const vite__injectQuery = (url, queryToInject) => {\n` +
+        `  if (typeof url !== 'string') return url;\n` +
+        `  if (url[0] !== '.' && url[0] !== '/') return url;\n` +
+        `  const pathname = url.replace(/[?#].*$/, '');\n` +
+        `  let search = '', hash = '';\n` +
+        `  try { const u = new URL(url, 'http://vite.dev'); search = u.search || ''; hash = u.hash || ''; } catch {}\n` +
+        `  return pathname + '?' + queryToInject + (search ? '&' + search.slice(1) : '') + (hash || '');\n` +
+        `};\n` +
+        `export default { ${defaultListing} };\n`;
+    return options.requireGuardSnippet + code;
+}
+/**
+ * Resolve the set of names the bridge should re-export for `nativescript-vue`
+ * given a project root. Static discovery via `enumeratePackageExports` is the
+ * only source — there is no curated fallback. If `nativescript-vue` is not
+ * resolvable from `projectRoot`, the returned set is empty and the bridge
+ * built from it will not emit passthroughs; the caller should treat that as
+ * the misconfiguration it is rather than mask it with a stale baseline.
+ *
+ * Caching lives inside `enumeratePackageExports`, so repeated calls in a dev
+ * session are effectively free.
+ */
+export function discoverNsvBridgeExports(projectRoot) {
+    const out = new Set();
+    const shape = enumeratePackageExports('nativescript-vue', projectRoot);
+    for (const n of shape.names) {
+        if (typeof n === 'string' && IDENT_RE.test(n))
+            out.add(n);
+    }
+    return out;
+}
+//# sourceMappingURL=ns-rt-bridge.js.map

package/hmr/server/ns-rt-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-rt-bridge.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/ns-rt-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,0EAA0E;AAC1E,6EAA6E;AAC7E,0EAA0E;AAC1E,4DAA4D;AAC5D,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAE7H,4EAA4E;AAC5E,0DAA0D;AAC1D,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvI,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAsB9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA0B;IAC/D,iFAAiF;IACjF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3H,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IACD,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAExD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5G,MAAM,cAAc,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/H,MAAM,IAAI,GACT,sFAAsF;QACtF,sFAAsF;QACtF,uFAAuF;QACvF,uFAAuF;QACvF,yFAAyF;QACzF,wDAAwD;QACxD,+IAA+I;QAC/I,uEAAuE;QACvE,sEAAsE;QACtE,sEAAsE;QACtE,uEAAuE;QACvE,qEAAqE;QACrE,qIAAqI;QACrI,yBAAyB;QACzB,qDAAqD;QACrD,oHAAoH;QACpH,2BAA2B;QAC3B,2BAA2B;QAC3B,gGAAgG;QAChG,8OAA8O;QAC9O,wBAAwB;QACxB,0CAA0C;QAC1C,oBAAoB;QACpB,qKAAqK;QACrK,2IAA2I;QAC3I,kDAAkD;QAClD,uBAAuB;QACvB,uBAAuB;QACvB,gBAAgB;QAChB,KAAK;QACL,sEAAsE;QACtE,oEAAoE;QACpE,iEAAiE;QACjE,oEAAoE;QACpE,qEAAqE;QACrE,gDAAgD;QAChD,SAAS;QACT,kEAAkE;QAClE,gBAAgB;QAChB,yMAAyM;QACzM,iBAAiB;QACjB,uDAAuD;QACvD,mDAAmD;QACnD,mIAAmI;QACnI,SAAS;QACT,OAAO;QACP,cAAc;QACd,0CAA0C;QAC1C,wEAAwE;QACxE,kBAAkB;QAClB,IAAI;QACJ,qEAAqE;QACrE,sEAAsE;QACtE,iEAAiE;QACjE,gCAAgC;QAChC,kpCAAkpC;QAClpC,02BAA02B;QAC12B,yXAAyX;QACzX,6EAA6E;QAC7E,8DAA8D;QAC9D,8CAA8C;QAC9C,uDAAuD;QACvD,kDAAkD;QAClD,iCAAiC;QACjC,+GAA+G;QAC/G,mGAAmG;QACnG,MAAM;QACN,oBAAoB,cAAc,OAAO,CAAC;IAE3C,OAAO,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,KAAK,GAAG,uBAAuB,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/hmr/server/ns-rt-route.d.ts

@@ -0,0 +1,5 @@
+import type { ViteDevServer } from 'vite';
+export interface NsRtRouteOptions {
+    getGraphVersion(): number;
+}
+export declare function registerNsRtBridgeRoute(server: ViteDevServer, options: NsRtRouteOptions): void;

package/hmr/server/ns-rt-route.js

@@ -0,0 +1,35 @@
+import { getProjectRootPath } from '../../helpers/project.js';
+import { buildNsRtBridgeModule, discoverNsvBridgeExports } from './ns-rt-bridge.js';
+import { REQUIRE_GUARD_SNIPPET } from './require-guard.js';
+import { setDeviceModuleHeaders } from './route-helpers.js';
+// ESM runtime bridge for NativeScript-Vue: `GET /ns/rt[/<ver>]`.
+//
+// Serves a single authoritative source of Vue helpers bound to the
+// NativeScript renderer. The bridge lazily resolves helpers from the vendor
+// registry on first evaluation (it does not statically import `vue`), then
+// re-exports them so SFCs can call them during module evaluation. The shared
+// `buildNsRtBridgeModule` owns the body (preamble, passthroughs, HMR shims,
+// polyfills, default export); discovery is the only source of truth for which
+// vendor symbols are forwarded.
+export function registerNsRtBridgeRoute(server, options) {
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const urlObj = new URL(req.url || '', 'http://localhost');
+            // Accept only /ns/rt and /ns/rt/<ver> for cache-busting semantics
+            if (!(urlObj.pathname === '/ns/rt' || /^\/ns\/rt\/[\d]+$/.test(urlObj.pathname)))
+                return next();
+            setDeviceModuleHeaders(res);
+            const rtVerSeg = urlObj.pathname.replace(/^\/ns\/rt\/?/, '');
+            const rtVer = /^[0-9]+$/.test(rtVerSeg) ? rtVerSeg : String(options.getGraphVersion() || 0);
+            const vendorExports = discoverNsvBridgeExports(getProjectRootPath());
+            const code = buildNsRtBridgeModule({ rtVer, requireGuardSnippet: REQUIRE_GUARD_SNIPPET, vendorExports });
+            res.statusCode = 200;
+            res.end(code);
+        }
+        catch {
+            res.statusCode = 500;
+            res.end('export {}\n');
+        }
+    });
+}
+//# sourceMappingURL=ns-rt-route.js.map

package/hmr/server/ns-rt-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-rt-route.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/ns-rt-route.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAQ5D,iEAAiE;AACjE,EAAE;AACF,mEAAmE;AACnE,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,gCAAgC;AAChC,MAAM,UAAU,uBAAuB,CAAC,MAAqB,EAAE,OAAyB;IACvF,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC1D,kEAAkE;YAClE,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAC;YAChG,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5F,MAAM,aAAa,GAAG,wBAAwB,CAAC,kBAAkB,EAAE,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,qBAAqB,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,CAAC,CAAC;YACzG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACR,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/hmr/server/perf-instrumentation.d.ts

@@ -0,0 +1,114 @@
+export type ServerStartupBannerInput = {
+    version: string;
+    transformConcurrency: number;
+    transformCacheMs: number;
+    lazyInitialGraph: boolean;
+    graphVersion: number;
+};
+export declare function formatServerStartupBanner(input: ServerStartupBannerInput): string;
+/**
+ * Classify a URL path into a coarse route category. Any pathname that
+ * doesn't match a known NativeScript dev route is reported as `other`;
+ * callers are expected to filter their own irrelevant routes before
+ * calling `record()`.
+ */
+export declare function classifyBootRoute(pathname: string): BootRouteCategory;
+export type BootRouteCategory = 'ns/m' | 'ns/rt' | 'ns/core' | 'ns/vendor' | 'ns/import-map' | 'ns/boot' | 'ns/hmr' | 'ns/other' | 'other';
+export type ColdBootRequestCounter = {
+    record: (url: string) => RecordHandle;
+    finalize: () => void;
+    getState: () => ColdBootCounterState;
+};
+export type RecordHandle = {
+    finish: () => void;
+};
+export type ColdBootCounterState = {
+    active: boolean;
+    count: number;
+    inFlight: number;
+    maxConcurrent: number;
+    startedAt: number | null;
+    firstRequestUrl: string | null;
+    perRoute: Partial<Record<BootRouteCategory, number>>;
+};
+export type ColdBootCounterOptions = {
+    /**
+     * Emit a rolling summary every N requests (default 100). Lower the
+     * threshold in tests to keep them snappy. Set to 0 to disable rolling
+     * summaries; a final summary still fires from `finalize()`.
+     */
+    summaryEvery?: number;
+    /**
+     * Cold-boot window closes when no new requests arrive within this
+     * idle window (default 5000ms). The HMR edit loop reuses the same
+     * handler, but it never bursts as heavily as cold boot. Raise this
+     * via `NS_VITE_HMR_BOOT_TRACE_IDLE_MS` when profiling a slow boot
+     * so inter-wave pauses don't close the counter prematurely.
+     */
+    idleWindowMs?: number;
+    /** Defaults to `Date.now`; tests inject a deterministic clock. */
+    now?: () => number;
+    /** Defaults to `setTimeout`; tests can inject a fake timer. */
+    setTimer?: (handler: () => void, ms: number) => unknown;
+    /** Defaults to `clearTimeout`; tests can inject a fake timer. */
+    clearTimer?: (handle: unknown) => void;
+    /** Logger called for every summary line (rolling + final). */
+    log: (line: string) => void;
+};
+export declare function createColdBootRequestCounter(options: ColdBootCounterOptions): ColdBootRequestCounter;
+export type PopulateInitialGraphSummary = {
+    moduleCount: number;
+    durationMs: number;
+    graphVersion: number;
+    bumpedVersion: boolean;
+};
+export declare function formatPopulateInitialGraphSummary(input: PopulateInitialGraphSummary): string;
+export type HmrUpdateKind = 'ts' | 'html' | 'css' | 'vue' | 'tsx' | 'jsx' | 'js' | 'mjs' | 'unknown';
+/**
+ * Classify a file's HMR update kind by extension. Used by the server-side
+ * update summary so a quick log line tells us which pipeline ran. Returns
+ * `'unknown'` for anything that doesn't match a known dev-time extension —
+ * the caller decides whether to log it or skip it entirely.
+ */
+export declare function classifyHmrUpdateKind(file: string): HmrUpdateKind;
+export type HmrUpdateSummary = {
+    /** Project-relative or absolute path of the file that triggered HMR. */
+    file: string;
+    /** File classification. */
+    kind: HmrUpdateKind;
+    /** Time spent waiting for `populateInitialGraph` to complete (ms). */
+    awaitMs: number;
+    /** Time spent in framework-specific work (graph updates, invalidation). */
+    frameworkMs: number;
+    /** Time spent broadcasting the WebSocket message. */
+    broadcastMs: number;
+    /** End-to-end handler time. */
+    totalMs: number;
+    /** Number of modules invalidated by the update. */
+    invalidated: number;
+    /** Number of HMR clients the message was sent to. */
+    recipients: number;
+    /**
+     * Angular-only narrowing decision: whether transitive-importer
+     * invalidation was narrowed because the changed file lacks Angular
+     * semantic decorators (`@Component`/`@Directive`/`@Pipe`/`@Injectable`/
+     * `@NgModule`). `true` means narrow (importers preserved, ESM live
+     * bindings carry the change). `false` means broad (importers also
+     * invalidated). `null`/`undefined` means the field is not applicable
+     * to this update (e.g. CSS, non-Angular flavor) and the field is
+     * omitted from the summary line entirely.
+     */
+    narrowed?: boolean | null;
+};
+/**
+ * Single-line summary for the server side of an HMR update. Always-on so
+ * a 6-second `.ts` save is immediately visible without flipping verbose.
+ * Format:
+ *   [hmr-ws][update] kind=ts file=/src/foo.ts await=12ms framework=180ms broadcast=2ms total=194ms invalidated=23 recipients=1
+ *
+ * For Angular `.ts` updates, `narrowed=yes|no` is appended so the
+ * narrowing decision is immediately visible without flipping verbose:
+ *   [hmr-ws][update] kind=ts file=/src/app/foo.constants.ts ... invalidated=1 recipients=1 narrowed=yes
+ *   [hmr-ws][update] kind=ts file=/src/app/foo.component.ts ... invalidated=132 recipients=1 narrowed=no
+ */
+export declare function formatHmrUpdateSummary(input: HmrUpdateSummary): string;