@nativescript/vite 8.0.0-alpha.9 → 8.0.0-dev.0

package/hmr/frameworks/react/server/strategy.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkServerStrategy } from '../../../server/framework-strategy.js';
+export declare const reactServerStrategy: FrameworkServerStrategy;

package/hmr/frameworks/react/server/strategy.js

@@ -0,0 +1,230 @@
+import { createRequire } from 'node:module';
+import { readFileSync, existsSync } from 'node:fs';
+import * as path from 'node:path';
+import { typescriptServerStrategy } from '../../typescript/server/strategy.js';
+import { runHotUpdatePrologue } from '../../../server/websocket-hot-update.js';
+import { purgeTransformCachesForHotUpdate } from '../../../server/transform-cache-invalidation.js';
+// React server strategy for NativeScript HMR.
+//
+// React renders through DOMiNATIVE via `@nativescript-community/react` and runs
+// WITHOUT React Fast Refresh (module-level reload, mirroring the Solid flavor's
+// `hot: false`). It therefore needs no framework-specific HMR transform — it
+// reuses the generic TypeScript strategy's device-module pipeline verbatim
+// (HTTP-loaded modules, vendor bridge, shared graph delta on hot update).
+//
+// The important part is that this is REGISTERED in `STRATEGY_REGISTRY`: the
+// server-side HMR plugin (which installs the `/ns/*` device routes — `/ns/core`,
+// `/ns/import-map.json`, `/ns/m`, `/ns/entry-rt`, …) is only added for flavors
+// with a registered strategy. Without it, a React project's dev server serves no
+// `/ns/*` routes and the app fails at boot fetching `/ns/core/xhr` (404).
+// ── React-ecosystem CJS named-export interop (the `transformNodeModule` hook) ──
+//
+// React and friends ship the classic prod/dev conditional re-export wrapper:
+//
+//     if (process.env.NODE_ENV === 'production') module.exports = require('./cjs/x.production.js');
+//     else module.exports = require('./cjs/x.development.js');
+//
+// Served raw over `/ns/m`, that wrapper exposes ONLY a default export — the device's
+// ESM loader can't see the names (`jsx`, `useSyncExternalStoreWithSelector`, …)
+// because they materialize on `module.exports` only at runtime, through the
+// conditional require. So a consumer's `import { useSyncExternalStoreWithSelector }`
+// (or `{ jsx }` from react/jsx-runtime, etc.) fails with "does not provide an export
+// named …". The non-HMR rolldown build bundles these fine; this only affects the
+// HMR/dev `/ns/m` path.
+//
+// The DEVELOPMENT target file is plain CJS (`exports.x = …`), whose named exports
+// the `/ns/m` pipeline DOES statically surface. So we rewrite the wrapper to
+// re-export EXPLICIT names from its development target. (We can't `export *` — the
+// device transform downgrades export-star to a side-effect import — so we read the
+// dev file and list the names.) Generic: works for any such wrapper, no per-package
+// shim.
+const projectRequire = createRequire(path.join(process.cwd(), 'package.json'));
+// react/jsx-runtime is the hottest of these (every JSX module imports it). Serve a
+// self-contained shim built on React.createElement so it never depends on the
+// internals of react's dev jsx-runtime file. (App-code imports are already routed
+// here by the resolve alias in configuration/react.ts; this covers vendored
+// importers served through `/ns/m`.)
+const REACT_JSX_RUNTIME_RE = /(^|[\\/])react[\\/]jsx-(?:dev-)?runtime(?:[\\/.]|$)/;
+const REACT_JSX_RUNTIME_SHIM = [
+    `import { createElement, Fragment as __NS_Fragment } from 'react';`,
+    `export const Fragment = __NS_Fragment;`,
+    `function __ns_jsx(type, config, maybeKey) {`,
+    `  if (maybeKey !== undefined) return createElement(type, Object.assign({}, config || {}, { key: maybeKey }));`,
+    `  return createElement(type, config);`,
+    `}`,
+    `export function jsx(type, config, maybeKey) { return __ns_jsx(type, config, maybeKey); }`,
+    `export function jsxs(type, config, maybeKey) { return __ns_jsx(type, config, maybeKey); }`,
+    `export function jsxDEV(type, config, maybeKey) { return __ns_jsx(type, config, maybeKey); }`,
+].join('\n');
+// Lex `exports.NAME = …` / `Object.defineProperty(exports, "NAME", …)` from a CJS
+// development file (the prod/dev targets are plain CJS, statically lexable).
+function lexCjsExportNames(filePath) {
+    let src = '';
+    try {
+        src = readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const names = new Set();
+    for (const m of src.matchAll(/\bexports\.([A-Za-z_$][\w$]*)\s*=/g))
+        names.add(m[1]);
+    for (const m of src.matchAll(/Object\.defineProperty\(\s*exports\s*,\s*['"]([A-Za-z_$][\w$]*)['"]/g))
+        names.add(m[1]);
+    names.delete('default');
+    names.delete('__esModule');
+    return Array.from(names);
+}
+// Resolve a wrapper module's development-target relative require (`devRel`) to an
+// absolute fs path. `moduleId` is the wrapper's id (an fs path, or a
+// `…/node_modules/<pkg>/<sub>` url/id). We find the wrapper's fs path — directly if
+// it's already absolute, otherwise by resolving its public package subpath spec —
+// then join `devRel` against the wrapper's directory (the dev file is internal, so
+// it can't be import-resolved directly under an `exports` map).
+function resolveDevTargetPath(moduleId, devRel) {
+    const clean = (moduleId || '').replace(/[?#].*$/, '');
+    if (!clean)
+        return null;
+    let wrapperPath = null;
+    if (path.isAbsolute(clean) && existsSync(clean)) {
+        wrapperPath = clean;
+    }
+    else {
+        const nm = clean.match(/node_modules[\\/]((?:@[^\\/]+[\\/])?[^\\/]+[\\/].*)$/);
+        if (nm) {
+            const subpath = nm[1].split(path.sep).join('/');
+            for (const spec of [subpath.replace(/\.(?:js|mjs|cjs)$/, ''), subpath]) {
+                try {
+                    wrapperPath = projectRequire.resolve(spec);
+                    break;
+                }
+                catch { }
+            }
+        }
+    }
+    if (!wrapperPath)
+        return null;
+    const devPath = path.resolve(path.dirname(wrapperPath), devRel);
+    return existsSync(devPath) ? devPath : null;
+}
+// If `code` is a prod/dev conditional re-export wrapper, return an ESM module that
+// re-exports the development target's explicit named exports (+ default). Returns
+// null otherwise so non-matching modules pass through untouched. Detection is
+// intentionally narrow (requires the `module.exports = require(...)` indirection
+// AND both a `.production.js` and `.development.js` target) so it only fires on the
+// React-ecosystem prod/dev idiom.
+function buildCondRequireReexport(code, moduleId) {
+    if (!/module\.exports\s*=\s*require\(/.test(code))
+        return null;
+    const devMatch = code.match(/require\(\s*['"]([^'"]+\.development\.js)['"]\s*\)/);
+    const hasProd = /require\(\s*['"][^'"]+\.production\.js['"]\s*\)/.test(code);
+    if (!devMatch || !hasProd)
+        return null;
+    const devRel = devMatch[1]; // e.g. '../cjs/use-sync-external-store-shim/with-selector.development.js'
+    // Resolve the dev target to an fs path so we can lex its export names. The dev
+    // file is an INTERNAL package file — usually exports-gated, so it can't be
+    // resolved as `pkg/cjs/…` directly. Instead resolve the (public) WRAPPER to its
+    // fs path and join the relative dev path against the wrapper's directory.
+    const devPath = resolveDevTargetPath(moduleId, devRel);
+    if (!devPath)
+        return null;
+    const names = lexCjsExportNames(devPath);
+    // Re-export by the ORIGINAL relative path so the device transform rewrites it to
+    // the dev target's `/ns/m` URL (served with real named exports). Explicit names
+    // only — `export *` is downgraded to a side-effect import by the device transform.
+    const target = JSON.stringify(devRel);
+    const lines = [];
+    if (names.length)
+        lines.push(`export { ${names.join(', ')} } from ${target};`);
+    lines.push(`export { default } from ${target};`);
+    return lines.join('\n');
+}
+export const reactServerStrategy = {
+    ...typescriptServerStrategy,
+    flavor: 'react',
+    transformNodeModule(code, moduleId, _verbose) {
+        if (moduleId && REACT_JSX_RUNTIME_RE.test(moduleId)) {
+            return REACT_JSX_RUNTIME_SHIM;
+        }
+        return buildCondRequireReexport(code, moduleId || '') ?? code;
+    },
+    // Like Solid (and unlike plain TypeScript, which recovers via a full
+    // `resetRootView`), React HMR applies an edit by having the CLIENT re-fetch +
+    // re-evaluate the just-changed route module and read its fresh
+    // `Route.options.component`. So the server MUST purge its transform caches
+    // BEFORE the client re-imports — otherwise the client races the server and the
+    // `/ns/m` re-fetch returns the PREVIOUS save's transform → V8 evaluates stale
+    // code → the visible page is "one save behind". The default TS strategy
+    // broadcasts the delta immediately (no purge), which is why React edits never
+    // applied. We mirror Solid's contract: defer the prologue's delta broadcast,
+    // purge the shared + Vite transform caches for the file AND its transitive
+    // importers (the route tree statically imports the route), re-transform fresh,
+    // then broadcast the delta.
+    deferDeltaBroadcast: true,
+    async handleHotUpdate(ctx, deps) {
+        const state = await runHotUpdatePrologue(ctx, deps);
+        if (!state)
+            return;
+        const { root, metrics, emitSummary } = state;
+        const { moduleGraph, verbose, sharedTransformRequest } = deps;
+        const { file, server } = ctx;
+        const isAppScriptFile = /\.(tsx?|jsx?)$/i.test(file);
+        if (!isAppScriptFile) {
+            emitSummary();
+            return;
+        }
+        metrics.tAfterFramework = Date.now();
+        try {
+            const rel = '/' + path.posix.normalize(path.relative(root, file)).split(path.sep).join('/');
+            const normalizedId = moduleGraph.normalizeGraphId(rel);
+            if (!moduleGraph.get(normalizedId)) {
+                moduleGraph.upsert(rel, `/* react-hmr ${Date.now()} */`, [], { emitDeltaOnInsert: true });
+            }
+            // Purge BOTH the shared transform-request cache and Vite's moduleGraph
+            // transformResult for the changed file + its bounded transitive importers
+            // (route tree → route file), so the client's re-import evaluates fresh code.
+            purgeTransformCachesForHotUpdate({ file, server, sharedTransformRequest, verbose, label: 'react' });
+            // Re-transform AFTER invalidation so the broadcast hash matches fresh
+            // content (the prologue's upsert ran before Vite's auto-invalidate fired).
+            try {
+                const ext = file.match(/\.(?:[mc]?[jt]sx?)$/i)?.[0] || '';
+                const baseSpec = '/' + path.posix.normalize(path.relative(root, file)).split(path.sep).join('/');
+                const baseNoExt = ext ? baseSpec.replace(/\.(?:[mc]?[jt]sx?)$/i, '') : baseSpec;
+                const candidates = Array.from(new Set([baseSpec, baseNoExt, baseNoExt + '.ts', baseNoExt + '.tsx', baseNoExt + '.js', baseNoExt + '.jsx', baseNoExt + '.mjs', file]));
+                let freshCode = '';
+                for (const cand of candidates) {
+                    try {
+                        const fresh = await sharedTransformRequest(cand, 30000);
+                        if (fresh?.code && !freshCode)
+                            freshCode = fresh.code;
+                    }
+                    catch { }
+                }
+                if (freshCode) {
+                    const existingGm = moduleGraph.get(normalizedId);
+                    moduleGraph.upsert(normalizedId, freshCode, (existingGm?.deps || []), { broadcastDelta: false });
+                }
+            }
+            catch (e) {
+                if (verbose)
+                    console.warn('[hmr-ws][react] post-invalidation re-transform failed', e);
+            }
+            // Broadcast the now-fresh delta, AFTER cache invalidation.
+            try {
+                const gm = moduleGraph.get(normalizedId);
+                if (gm)
+                    moduleGraph.emitDelta([gm], []);
+            }
+            catch (e) {
+                if (verbose)
+                    console.warn('[hmr-ws][react] post-invalidation broadcast failed', e);
+            }
+        }
+        catch (e) {
+            if (verbose)
+                console.warn('[hmr-ws][react] failed to handle hot update for', file, e);
+        }
+        emitSummary();
+    },
+};
+//# sourceMappingURL=strategy.js.map

package/hmr/frameworks/react/server/strategy.js.map

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

package/hmr/frameworks/solid/build/solid-jsx-deps.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Find installed packages whose pre-bundle output would smuggle JSX into
+ * Vite's import-analysis stage. Returned names are safe to drop into
+ * `optimizeDeps.exclude` — the dev server will serve them through the
+ * normal module pipeline, where `vite-plugin-solid` can transform their
+ * original `.jsx`/`.tsx` files.
+ *
+ * The function is intentionally synchronous and best-effort: filesystem
+ * errors are swallowed, missing directories are skipped, and the scan
+ * caps at {@link MAX_SCAN_DEPTH} levels per package. Callers should
+ * treat the empty-array result as "no exclusions needed", not "scan
+ * failed". A nullable `monorepoRoot` is accepted so workspace hoisting
+ * is covered without forcing every caller to compute it.
+ */
+export declare function findSolidPackagesShippingJsx(projectRoot: string, monorepoRoot?: string | null): string[];

package/hmr/frameworks/solid/build/solid-jsx-deps.js

@@ -0,0 +1,178 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Why this helper exists
+ * ----------------------
+ *
+ * Vite's depscanner happily pre-bundles every bare specifier the app
+ * imports. For a Solid library that publishes pre-compiled-but-still-JSX
+ * files (e.g. `solid-navigation`'s `dist/src/*.jsx`), the pre-bundle output
+ * lands at `node_modules/.vite/deps/<pkg>.js` with the JSX intact —
+ * rolldown's depscanner doesn't run Solid's JSX transform (that lives in
+ * `vite-plugin-solid`'s `transform` hook, which only matches files whose
+ * id ends in `.jsx`/`.tsx`).
+ *
+ * Vite then runs `vite:import-analysis` on the `.js` output, hits the
+ * first JSX expression, and aborts the dev server's pre-transform with:
+ *
+ *   Failed to parse source for import analysis because the content
+ *   contains invalid JS syntax. If you are using JSX, make sure to
+ *   name the file with the .jsx or .tsx extension.
+ *   File: /…/.vite/deps/<pkg>.js:51:32
+ *
+ * The fix: when a project depends on a Solid library that ships `.jsx`
+ * (or `.tsx`) source files in its package directory, mark that package
+ * as `optimizeDeps.exclude` so Vite serves it through the regular dev
+ * pipeline, where `vite-plugin-solid`'s `transform` hook matches the
+ * original `.jsx` id and applies the Solid babel preset.
+ *
+ * Detection rules — biased toward false negatives so we never wrongly
+ * exclude a package that Vite must pre-bundle (esp. CJS-only deps that
+ * need esm interop). A package is excluded only when ALL of the
+ * following hold:
+ *
+ *   1. It declares `solid-js` or `@nativescript-community/solid-js` in
+ *      `dependencies` / `peerDependencies` / `devDependencies`. This is
+ *      a strong signal that the package's published artifacts are
+ *      meant to be processed by a Solid-aware JSX transformer.
+ *   2. Its package directory contains at least one `.jsx` / `.tsx`
+ *      source file under `dist` / `lib` / `build` / `es` / `esm` /
+ *      `out` (the common published-output dirs) or directly at the
+ *      package root. We deliberately skip `node_modules`, `src` (raw
+ *      sources, not what `main` points to), and test dirs.
+ *
+ * Both checks are scoped to packages installed in the app's
+ * `node_modules` (plus the monorepo's hoisted `node_modules`, if any)
+ * — we never recurse into transitive nested copies, since those are
+ * also reachable from the same top-level scan once Vite resolves them.
+ */
+const PUBLISHED_OUTPUT_DIRS = new Set(['dist', 'lib', 'build', 'es', 'esm', 'out']);
+// Always-skip subdirs regardless of depth: nested copies, test fixtures,
+// docs, and example apps. Notably `src` is NOT in here because a published
+// bundle may use `dist/src/<file>.jsx` as its layout (e.g. `solid-navigation`).
+// `src/` at the *package root* is rejected separately by the
+// "depth 0 must be a published-output dir" gate below.
+const ALWAYS_SKIP_DIR_NAMES = new Set(['node_modules', 'test', 'tests', '__tests__', 'spec', 'specs', 'docs', 'examples', 'example', '.git', '.cache']);
+const JSX_EXT_RE = /\.(jsx|tsx)$/;
+const MAX_SCAN_DEPTH = 4;
+function isSolidConsumer(pkgJson) {
+    const buckets = ['dependencies', 'peerDependencies', 'devDependencies', 'optionalDependencies'];
+    for (const key of buckets) {
+        const deps = pkgJson[key];
+        if (!deps || typeof deps !== 'object')
+            continue;
+        if (deps['solid-js'])
+            return true;
+        if (deps['@nativescript-community/solid-js'])
+            return true;
+    }
+    return false;
+}
+function hasJsxFile(dir, depth = 0) {
+    if (depth > MAX_SCAN_DEPTH)
+        return false;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (entry.isFile() && JSX_EXT_RE.test(entry.name)) {
+            return true;
+        }
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith('.'))
+                continue;
+            if (ALWAYS_SKIP_DIR_NAMES.has(entry.name))
+                continue;
+            // At depth 0 (package root) only descend into known
+            // published-output dirs so a sibling `src/` (raw sources)
+            // can't flag the package on its own. Deeper levels are
+            // inside a publish dir already, so any subdir (incl. `src`)
+            // is fair game.
+            if (depth === 0 && !PUBLISHED_OUTPUT_DIRS.has(entry.name))
+                continue;
+            if (hasJsxFile(path.join(dir, entry.name), depth + 1))
+                return true;
+        }
+    }
+    return false;
+}
+function scanDirectoryForJsxPackages(nodeModulesDir, result, scope = '') {
+    let entries;
+    try {
+        entries = fs.readdirSync(nodeModulesDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.startsWith('.'))
+            continue;
+        if (entry.name === 'node_modules')
+            continue;
+        const entryPath = path.join(nodeModulesDir, entry.name);
+        if (!scope && entry.name.startsWith('@')) {
+            scanDirectoryForJsxPackages(entryPath, result, entry.name);
+            continue;
+        }
+        const pkgName = scope ? `${scope}/${entry.name}` : entry.name;
+        if (result.has(pkgName))
+            continue;
+        const pkgJsonPath = path.join(entryPath, 'package.json');
+        if (!fs.existsSync(pkgJsonPath))
+            continue;
+        let pkgJson;
+        try {
+            pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (!isSolidConsumer(pkgJson))
+            continue;
+        if (!hasJsxFile(entryPath))
+            continue;
+        result.add(pkgName);
+    }
+}
+/**
+ * Find installed packages whose pre-bundle output would smuggle JSX into
+ * Vite's import-analysis stage. Returned names are safe to drop into
+ * `optimizeDeps.exclude` — the dev server will serve them through the
+ * normal module pipeline, where `vite-plugin-solid` can transform their
+ * original `.jsx`/`.tsx` files.
+ *
+ * The function is intentionally synchronous and best-effort: filesystem
+ * errors are swallowed, missing directories are skipped, and the scan
+ * caps at {@link MAX_SCAN_DEPTH} levels per package. Callers should
+ * treat the empty-array result as "no exclusions needed", not "scan
+ * failed". A nullable `monorepoRoot` is accepted so workspace hoisting
+ * is covered without forcing every caller to compute it.
+ */
+export function findSolidPackagesShippingJsx(projectRoot, monorepoRoot) {
+    const found = new Set();
+    const seenDirs = new Set();
+    const scanDirs = [];
+    const projectNodeModules = path.resolve(projectRoot, 'node_modules');
+    scanDirs.push(projectNodeModules);
+    if (monorepoRoot && path.resolve(monorepoRoot) !== path.resolve(projectRoot)) {
+        const monorepoNodeModules = path.resolve(monorepoRoot, 'node_modules');
+        scanDirs.push(monorepoNodeModules);
+    }
+    for (const dir of scanDirs) {
+        const key = path.resolve(dir);
+        if (seenDirs.has(key))
+            continue;
+        seenDirs.add(key);
+        if (!fs.existsSync(dir))
+            continue;
+        scanDirectoryForJsxPackages(dir, found);
+    }
+    return Array.from(found).sort();
+}
+//# sourceMappingURL=solid-jsx-deps.js.map

package/hmr/frameworks/solid/build/solid-jsx-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid-jsx-deps.js","sourceRoot":"","sources":["../../../../../../../packages/vite/hmr/frameworks/solid/build/solid-jsx-deps.ts"],"names":[],"mappings":"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"}

package/hmr/frameworks/solid/client/app-runtime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Bootstrap + HMR remount for NativeScript Solid apps.
+ *
+ * Solid runs with `hot: false` (solid-refresh is off — it rewrites `export
+ * function` into a non-hoisted const and breaks TanStack file-route modules), so
+ * there is no fine-grained component HMR.
+ *
+ * Division of labour on each Solid HMR cycle (`__ns_solid_hmr_subscribe`):
+ *   • ROUTE files — handled by @nativescript/tanstack-router's per-page remount
+ *     (`subscribeSolidHmrRemount` → `page.__ns_remount`), which swaps the route
+ *     component in place WITHOUT re-navigating, so the user stays on their route.
+ *     This helper does nothing for route-only edits.
+ *   • Everything else (app shell / shared components / app entry) — this helper
+ *     re-imports the app entry and re-renders the whole Solid tree. The router is
+ *     REUSED (its chain is never evicted), so the current route is preserved.
+ *
+ * Renderer bindings (`Application`, `render`, `document`) are passed in rather than
+ * imported here so the helper uses the app's exact solid-js / dominative instances.
+ * Importing our own copies could resolve to a different module realm and break
+ * Solid reactivity (NativeScript can load a package's deps in a separate realm).
+ */
+export interface StartSolidAppOptions {
+    /** `@nativescript/core` `Application`. */
+    Application: {
+        run(entry: {
+            create: () => any;
+        }): void;
+    };
+    /** `@nativescript-community/solid-js` `render` — mounts a component, returns a disposer. */
+    render: (component: any, target: any) => () => void;
+    /** dominative `document` — returned as the root view; `document.body` is the mount target. */
+    document: any;
+    /** Initial root component (used for the first mount). */
+    root: any;
+    /**
+     * App-relative specifier of the module that exports the root component, as
+     * `App` or default (e.g. `/src/native/app`). Re-imported fresh on each cycle.
+     */
+    rootModule: string;
+    /**
+     * Optional `@nativescript/core` `Frame` class. Pass it when the app uses a
+     * topmost-frame router (e.g. solid-navigation's `StackRouter` with
+     * `useTopMostFrame`): those routers re-run their initial navigation against
+     * `Frame.topmost()` when the fresh tree mounts. During a remount that would
+     * target a STALE frame from the old tree (often a nested tab frame) and push
+     * a backstack entry per edit. With `Frame` provided, the remount render
+     * redirects such navigations to the ROOT frame (`document.documentElement`)
+     * with `clearHistory: true`, so each HMR apply swaps the whole tree in place
+     * and disposes the old pages instead of stacking on top of them.
+     */
+    Frame?: any;
+}
+/**
+ * Boot a NativeScript Solid app and wire up HMR remounting. Call once from the
+ * app entry, e.g.:
+ *
+ *   import './utils/dom';
+ *   import { Application, Frame } from '@nativescript/core';
+ *   import { render } from '@nativescript-community/solid-js';
+ *   import { document } from 'dominative';
+ *   import { startSolidApp } from '@nativescript/vite/solid-bootstrap';
+ *   import { App } from './app';
+ *
+ *   // `Frame` is optional — pass it when using a topmost-frame router
+ *   // (solid-navigation) so HMR remounts replace the root page in place.
+ *   startSolidApp({ Application, render, document, Frame, root: App, rootModule: '/src/native/app' });
+ */
+export declare function startSolidApp(options: StartSolidAppOptions): void;