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

package/hmr/helpers/cjs-named-exports.js

@@ -0,0 +1,152 @@
+// Runtime-enumerated CommonJS named exports for the HMR `/ns/m` pipeline.
+//
+// Why this exists:
+// V8's HTTP-imported ES module loader (the device's `http-esm` mode) requires
+// named exports to be declared statically at parse time. Many real-world npm
+// packages do not declare their public surface statically — the canonical
+// example is lodash:
+//
+//   (freeModule.exports = _)._ = _;
+//
+// At parse time there are zero `exports.foo = ...` or
+// `Object.defineProperty(exports, 'foo', ...)` patterns. Lodash builds its
+// public surface dynamically inside an IIFE and attaches every method to a
+// function object that is then assigned to `module.exports`. Neither a
+// regex nor an AST can statically determine that lodash exposes
+// `capitalize`, `chunk`, `debounce`, etc.
+//
+// The only correct way to enumerate this kind of CJS module's public
+// surface is to actually load it in the dev server's Node context and ask
+// `Object.keys(...)`. This is exactly what esbuild and Vite do at build
+// time when they pre-bundle CJS deps for an ESM consumer; this helper
+// brings the same strategy to the HMR served-module pipeline so that
+// `import { capitalize } from 'lodash'` succeeds even when lodash is not
+// pre-bundled by Vite.
+//
+// Safety:
+// - Only call this for modules under `node_modules` (we never execute user
+//   source code via this path).
+// - Wrap in try/catch — some npm packages throw at load time (missing peer
+//   deps, browser-only globals, side effects). On any failure we return an
+//   empty list and the caller falls back to whatever it could detect
+//   statically.
+// - Cache by absolute path so a second HMR request for the same module is
+//   free.
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+const cache = new Map();
+const RESERVED = new Set(['default', '__esModule']);
+// `Object.getOwnPropertyNames` on a function exposes these implementation
+// details — they are not real exports.
+const FUNCTION_INTERNAL = new Set(['length', 'name', 'prototype', 'arguments', 'caller']);
+const VALID_IDENT = /^[A-Za-z_$][\w$]*$/;
+export function clearCjsNamedExportsCache(filePath) {
+    if (!filePath) {
+        cache.clear();
+    }
+    else {
+        cache.delete(filePath);
+    }
+}
+export function getCjsNamedExportsCacheSize() {
+    return cache.size;
+}
+/**
+ * Normalize a path that may have come from a Vite-resolved id (e.g.
+ * `/@fs/Users/.../node_modules/foo/index.js?import`) into a plain
+ * absolute filesystem path that `createRequire` can load.
+ *
+ * Returns null if the path does not look like an absolute filesystem
+ * path that exists on disk.
+ */
+export function normalizeAbsolutePathForRequire(input) {
+    if (!input)
+        return null;
+    let s = String(input).replace(/[?#].*$/, '');
+    // Vite serves absolute paths as `/@fs/<absolute>`; strip the prefix.
+    if (s.startsWith('/@fs/')) {
+        s = s.slice('/@fs'.length);
+    }
+    if (!path.isAbsolute(s))
+        return null;
+    try {
+        if (!fs.statSync(s).isFile())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return s;
+}
+/**
+ * Enumerate the named exports of a CommonJS module by loading it in the
+ * dev server's Node context.
+ *
+ * Returns an empty array if the module can't be loaded, isn't in
+ * node_modules, or doesn't expose any enumerable string-keyed properties
+ * that look like JS identifiers.
+ *
+ * Results are cached by absolute path. Pass `clearCjsNamedExportsCache()`
+ * if you need to invalidate (e.g. between tests).
+ */
+export function getCjsNamedExports(absolutePath) {
+    const normalized = normalizeAbsolutePathForRequire(absolutePath);
+    if (!normalized)
+        return [];
+    // Only enumerate node_modules paths — never execute user source via this code path.
+    if (!/(?:^|\/)node_modules\//.test(normalized))
+        return [];
+    const cached = cache.get(normalized);
+    if (cached !== undefined)
+        return cached || [];
+    let names = null;
+    try {
+        // `createRequire` needs a path that itself exists; the file we are
+        // enumerating is a fine anchor. The cwd of the require base is its
+        // parent directory, which matters for nested workspace resolution.
+        const req = createRequire(normalized);
+        const mod = req(normalized);
+        const collected = new Set();
+        const isFn = typeof mod === 'function';
+        if (mod && (typeof mod === 'object' || isFn)) {
+            // `Object.keys` returns enumerable own props — covers most CJS modules
+            // where named exports are real properties on the exports object.
+            try {
+                for (const k of Object.keys(mod)) {
+                    if (!RESERVED.has(k) && VALID_IDENT.test(k))
+                        collected.add(k);
+                }
+            }
+            catch {
+                /* exotic proxy etc. */
+            }
+            // `Object.getOwnPropertyNames` covers non-enumerable own props too.
+            // Lodash attaches a few methods that aren't enumerable; more importantly
+            // some packages mark exports non-enumerable on purpose.
+            try {
+                for (const k of Object.getOwnPropertyNames(mod)) {
+                    if (RESERVED.has(k) || !VALID_IDENT.test(k))
+                        continue;
+                    if (isFn && FUNCTION_INTERNAL.has(k))
+                        continue;
+                    collected.add(k);
+                }
+            }
+            catch {
+                /* exotic */
+            }
+            names = Array.from(collected);
+        }
+        else {
+            // Primitive default export (e.g. `module.exports = 'hello'`). No named exports possible.
+            names = [];
+        }
+    }
+    catch {
+        names = null;
+    }
+    cache.set(normalized, names);
+    return names || [];
+}
+//# sourceMappingURL=cjs-named-exports.js.map

package/hmr/helpers/cjs-named-exports.js.map

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

package/hmr/helpers/package-exports.d.ts

@@ -0,0 +1,16 @@
+export interface PackageExportShape {
+    /** Union of every named export reachable from the package entry, minus `default`. */
+    names: Set<string>;
+    /** True if any visited file emits a `default` export. */
+    hasDefault: boolean;
+    /** Absolute path to the resolved entry file (empty string when the package could not be resolved). */
+    entry: string;
+    /** Files visited during the walk — useful for diagnostics and cache invalidation. */
+    visitedFiles: string[];
+}
+/**
+ * Clear the cache. Tests use this to assert determinism; production code
+ * never needs it (the cache is intentionally process-lifetime).
+ */
+export declare function __clearPackageExportsCache(): void;
+export declare function enumeratePackageExports(packageId: string, projectRoot: string): PackageExportShape;

package/hmr/helpers/package-exports.js

@@ -0,0 +1,396 @@
+// Static export-surface enumerator for the single-realm HTTP-ESM bridge.
+//
+// The HMR runtime serves canonical bridge specifiers (e.g. `/ns/rt` for
+// `nativescript-vue`) that fan out to the device's vendor registry so that
+// app code, plugins, and the vendor bundle itself share one module record
+// per package. The bridge module must therefore re-export every public
+// symbol the underlying package offers — otherwise consumers fall back to
+// `undefined` for any export the bridge author forgot to enumerate, and the
+// failure only surfaces at the call site (often deep inside a UI event
+// handler) as `TypeError: <name> is not a function`.
+//
+// Hand-curated re-export lists are the source of that bug class. This
+// helper replaces them with a deterministic walk of the package's static
+// ESM export graph:
+//
+//   1. Resolve the package's `main` entry from the project's `node_modules`.
+//   2. Parse with Babel and collect every named export — both inline
+//      (`export const x = …`, `export function y() {}`, `export { z }`) and
+//      re-exported (`export { a, b as c } from './foo'`).
+//   3. Recurse into `export * from <spec>`, following both relative paths
+//      and bare package specifiers (so `export * from '@vue/runtime-core'`
+//      contributes the full Vue runtime API too).
+//   4. Cache the result by `${projectRoot}::${packageId}` — the walk
+//      touches dozens of files for `nativescript-vue` and we want one walk
+//      per dev session, not per request.
+//
+// The walker is intentionally permissive: parse errors and unresolvable
+// specifiers are swallowed (continue with what we have). The caller decides
+// what to do if the surface comes back empty (typically: fall back to a
+// known-good baseline list rather than emit a stub bridge).
+import { parse as babelParse } from '@babel/parser';
+import { readFileSync, existsSync, realpathSync } from 'fs';
+import path from 'path';
+import { createRequire } from 'node:module';
+const cache = new Map();
+/**
+ * Clear the cache. Tests use this to assert determinism; production code
+ * never needs it (the cache is intentionally process-lifetime).
+ */
+export function __clearPackageExportsCache() {
+    cache.clear();
+}
+export function enumeratePackageExports(packageId, projectRoot) {
+    const root = path.resolve(projectRoot || process.cwd());
+    const cacheKey = `${root}::${packageId}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    const result = {
+        names: new Set(),
+        hasDefault: false,
+        entry: '',
+        visitedFiles: [],
+    };
+    const rootRequire = createRequireFromDir(root);
+    const entry = resolvePackageEsmEntry(packageId, rootRequire);
+    if (!entry) {
+        cache.set(cacheKey, result);
+        return result;
+    }
+    result.entry = entry;
+    const visited = new Set();
+    const queue = [entry];
+    while (queue.length) {
+        const file = queue.shift();
+        const real = safeRealpath(file);
+        if (visited.has(real))
+            continue;
+        visited.add(real);
+        result.visitedFiles.push(real);
+        const source = readFileSafe(real);
+        if (source === null)
+            continue;
+        const program = parseModule(source);
+        if (!program)
+            continue;
+        const dir = path.dirname(real);
+        const localRequire = createRequireFromFile(real);
+        for (const node of program.body) {
+            collectExportsFromNode(node, result, (spec) => {
+                const next = resolveSpec(spec, dir, localRequire);
+                if (next)
+                    queue.push(next);
+            });
+        }
+    }
+    cache.set(cacheKey, result);
+    return result;
+}
+function collectExportsFromNode(node, out, queueReExportSource) {
+    if (node.type === 'ExportNamedDeclaration') {
+        // `export const x = …`, `export function y() {}`, `export class Z {}`
+        const decl = node.declaration;
+        if (decl) {
+            if (decl.declarations) {
+                for (const d of decl.declarations) {
+                    addId(out.names, d?.id);
+                }
+            }
+            else if (decl.id?.name) {
+                out.names.add(decl.id.name);
+            }
+        }
+        // `export { a, b as c }` and `export { a } from './foo'`
+        for (const spec of (node.specifiers || [])) {
+            const exportedName = spec?.exported?.name ?? spec?.exported?.value;
+            if (exportedName === 'default') {
+                out.hasDefault = true;
+            }
+            else if (exportedName) {
+                out.names.add(String(exportedName));
+            }
+        }
+        // `export … from <source>` — we already captured the explicit names above,
+        // but we still need to recurse if there's a `*` re-export hiding inside
+        // (Babel models that as `ExportAllDeclaration`, handled below). Nothing to do here.
+    }
+    else if (node.type === 'ExportAllDeclaration') {
+        // `export * from <source>` — recurse.
+        // `export * as ns from <source>` adds a named binding `ns` instead of fanning out.
+        const src = node.source?.value;
+        const asName = node.exported?.name;
+        if (asName) {
+            if (asName !== 'default')
+                out.names.add(String(asName));
+        }
+        else if (src) {
+            queueReExportSource(src);
+        }
+    }
+    else if (node.type === 'ExportDefaultDeclaration') {
+        out.hasDefault = true;
+    }
+}
+function addId(names, idNode) {
+    if (!idNode)
+        return;
+    if (idNode.type === 'Identifier' && idNode.name) {
+        names.add(idNode.name);
+        return;
+    }
+    if (idNode.type === 'ObjectPattern') {
+        for (const prop of idNode.properties || []) {
+            if (prop.type === 'ObjectProperty')
+                addId(names, prop.value);
+            else if (prop.type === 'RestElement')
+                addId(names, prop.argument);
+        }
+        return;
+    }
+    if (idNode.type === 'ArrayPattern') {
+        for (const el of idNode.elements || [])
+            addId(names, el);
+        return;
+    }
+    if (idNode.type === 'AssignmentPattern') {
+        addId(names, idNode.left);
+    }
+}
+function parseModule(source) {
+    try {
+        const ast = babelParse(source, {
+            sourceType: 'module',
+            plugins: ['typescript', 'jsx', 'importMeta', 'topLevelAwait', 'decorators-legacy', 'classProperties', 'classPrivateProperties', 'classPrivateMethods'],
+            errorRecovery: true,
+            allowReturnOutsideFunction: true,
+            allowUndeclaredExports: true,
+        });
+        return ast.program;
+    }
+    catch {
+        return null;
+    }
+}
+function resolveSpec(spec, dir, localRequire) {
+    if (!spec)
+        return null;
+    if (spec.startsWith('.')) {
+        return resolveRelative(dir, spec);
+    }
+    if (spec.startsWith('/')) {
+        return existsSync(spec) ? spec : null;
+    }
+    // Bare specifier (e.g. `@vue/runtime-core` from inside `nativescript-vue`).
+    // `createRequire.resolve()` is CJS-first and follows the package's `main`
+    // field, which for dual-format packages like `@vue/runtime-core` points at
+    // a CommonJS shim (`module.exports = require('./dist/…cjs.js')`) — parsing
+    // that as ESM yields zero exports and we silently drop the entire
+    // re-export chain. Use the ESM-aware resolver instead so we land on the
+    // actual `dist/…esm-bundler.js` advertised by `exports[".module"]` /
+    // `module`, where `export { ref, computed, … }` lives.
+    if (localRequire) {
+        return resolvePackageEsmEntry(spec, localRequire);
+    }
+    return null;
+}
+/**
+ * Resolve a bare specifier to its ESM entry file by consulting the package's
+ * own `package.json` ESM hints — in priority order:
+ *
+ *   1. `exports[<sub>].module` (Vue, modern dual-format packages)
+ *   2. `exports[<sub>].import`
+ *   3. `exports[<sub>]` shorthand (string form)
+ *   4. top-level `module` field (older dual-format convention)
+ *   5. top-level `main` (last resort; may be CJS — we'll parse what we get)
+ *
+ * `<sub>` is either `"."` (root entry) or `"./relative/subpath"`. Anything not
+ * declared in `exports` falls back to plain CJS resolution.
+ *
+ * Returns the absolute file path, or `null` if the package can't be located.
+ */
+function resolvePackageEsmEntry(spec, localRequire) {
+    const { packageName, subpath } = splitBareSpec(spec);
+    if (!packageName)
+        return null;
+    // Locate the package's `package.json` from the calling file's vantage point.
+    // Node ≥ 18.6 has `require.resolve('<pkg>/package.json')` working for almost
+    // every layout (including pnpm hoisted/nested), provided the package
+    // declares `package.json` reachable (it is, by default). If the package
+    // opts out of exposing it via `exports`, fall back to walking up from any
+    // resolvable entry.
+    let pkgJsonPath = safeResolve(localRequire, `${packageName}/package.json`);
+    if (!pkgJsonPath) {
+        const someEntry = safeResolve(localRequire, spec);
+        if (someEntry)
+            pkgJsonPath = findPackageJsonUpward(someEntry, packageName);
+    }
+    if (!pkgJsonPath)
+        return null;
+    const pkgDir = path.dirname(pkgJsonPath);
+    const pkg = readJsonSafe(pkgJsonPath);
+    if (!pkg)
+        return null;
+    const subKey = subpath ? `./${subpath}` : '.';
+    const esmRelative = pickEsmEntryFromManifest(pkg, subKey);
+    if (esmRelative) {
+        const resolved = resolveRelativeInsidePackage(pkgDir, esmRelative);
+        if (resolved)
+            return resolved;
+    }
+    // Last-resort fallback: ordinary CJS resolution. Parsing may yield zero
+    // exports (the file is genuinely CJS) — that's acceptable; the caller
+    // treats an empty contribution as "this package adds nothing" rather than
+    // erroring out.
+    return safeResolve(localRequire, spec);
+}
+function splitBareSpec(spec) {
+    if (spec.startsWith('@')) {
+        const parts = spec.split('/');
+        if (parts.length < 2)
+            return { packageName: '', subpath: '' };
+        return { packageName: `${parts[0]}/${parts[1]}`, subpath: parts.slice(2).join('/') };
+    }
+    const slash = spec.indexOf('/');
+    if (slash === -1)
+        return { packageName: spec, subpath: '' };
+    return { packageName: spec.slice(0, slash), subpath: spec.slice(slash + 1) };
+}
+function readJsonSafe(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function pickEsmEntryFromManifest(pkg, subKey) {
+    const exportsField = pkg?.exports;
+    if (exportsField && typeof exportsField === 'object') {
+        const entry = exportsField[subKey];
+        const fromConditional = pickEsmFromConditionalExports(entry);
+        if (fromConditional)
+            return fromConditional;
+    }
+    // `exports` as a bare string only applies to the `.` subpath.
+    if (typeof exportsField === 'string' && subKey === '.')
+        return exportsField;
+    if (subKey === '.') {
+        if (typeof pkg?.module === 'string')
+            return pkg.module;
+        if (typeof pkg?.main === 'string')
+            return pkg.main;
+        // CommonJS-only packages frequently omit `main`; Node defaults to `index.js`.
+        return 'index.js';
+    }
+    // Subpath without an `exports` mapping: caller falls through to CJS resolution.
+    return null;
+}
+function pickEsmFromConditionalExports(entry) {
+    if (!entry)
+        return null;
+    if (typeof entry === 'string')
+        return entry;
+    if (typeof entry !== 'object')
+        return null;
+    // Prefer `module` (the de-facto "ESM bundler" condition that Vue, lit,
+    // preact etc. ship), then `import`, then `default`. Skip `node`/`require`
+    // because those usually point at the CJS shim we're explicitly avoiding.
+    for (const key of ['module', 'import', 'default']) {
+        const value = entry[key];
+        if (typeof value === 'string')
+            return value;
+        if (value && typeof value === 'object') {
+            const nested = pickEsmFromConditionalExports(value);
+            if (nested)
+                return nested;
+        }
+    }
+    return null;
+}
+function resolveRelativeInsidePackage(pkgDir, rel) {
+    const trimmed = rel.replace(/^\.\//, '');
+    const candidates = [trimmed, `${trimmed}.js`, `${trimmed}.mjs`, `${trimmed}.cjs`, `${trimmed}/index.js`, `${trimmed}/index.mjs`];
+    for (const c of candidates) {
+        const p = path.join(pkgDir, c);
+        if (existsSync(p))
+            return safeRealpath(p);
+    }
+    return null;
+}
+function findPackageJsonUpward(startFile, expectedName) {
+    let dir = path.dirname(startFile);
+    const root = path.parse(dir).root;
+    while (dir && dir !== root) {
+        const candidate = path.join(dir, 'package.json');
+        if (existsSync(candidate)) {
+            const pkg = readJsonSafe(candidate);
+            if (pkg?.name === expectedName)
+                return candidate;
+        }
+        const next = path.dirname(dir);
+        if (next === dir)
+            break;
+        dir = next;
+    }
+    return null;
+}
+function resolveRelative(dir, spec) {
+    const base = path.resolve(dir, spec);
+    const candidates = ['', '.js', '.mjs', '.cjs', '/index.js', '/index.mjs', '/index.cjs'];
+    for (const ext of candidates) {
+        const p = base + ext;
+        try {
+            if (existsSync(p)) {
+                const real = safeRealpath(p);
+                // Skip directories returned by `existsSync` without an index file fallback.
+                try {
+                    const stat = readFileSafe(real);
+                    if (stat !== null)
+                        return real;
+                }
+                catch { }
+            }
+        }
+        catch { }
+    }
+    return null;
+}
+function safeResolve(req, spec) {
+    try {
+        return req.resolve(spec);
+    }
+    catch {
+        return null;
+    }
+}
+function createRequireFromDir(dir) {
+    // `createRequire` wants a file path; we pass a synthetic file under the
+    // dir so resolution starts there.
+    return createRequire(path.join(dir, 'package.json'));
+}
+function createRequireFromFile(file) {
+    try {
+        return createRequire(file);
+    }
+    catch {
+        return null;
+    }
+}
+function safeRealpath(file) {
+    try {
+        return realpathSync(file);
+    }
+    catch {
+        return file;
+    }
+}
+function readFileSafe(file) {
+    try {
+        return readFileSync(file, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=package-exports.js.map

package/hmr/helpers/package-exports.js.map

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

package/hmr/server/angular-root-component.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Identifies the Angular **bootstrap (root) component** of a project from
+ * its dev-server entry module, and provides helpers to match Analog's
+ * `angular:component-update` events against it.
+ *
+ * Why this exists
+ * ---------------
+ * NativeScript's root Angular component hosts the navigation `Frame` (via
+ * `<page-router-outlet>`). Analog's in-place template HMR
+ * (`ɵɵreplaceMetadata`) recreates the matching `LView`s for the edited
+ * component WITHOUT re-running router navigation. For a normal child
+ * component that's exactly right — its view re-renders inside an intact
+ * page. For the ROOT component it's fatal: replacing the root metadata
+ * tears down the `PageRouterOutlet`'s `Frame` and nothing re-navigates,
+ * leaving a permanent blank/white screen that no further in-place update
+ * can recover.
+ *
+ * The reboot path (`ns:angular-update` → `__reboot_ng_modules__`) DOES
+ * recover the root view (it re-bootstraps and replays route state). So the
+ * fix is to route every root-component edit through the reboot path and
+ * suppress the destructive in-place update for it. Both halves need to know
+ * which file is the root component — that's what this module resolves.
+ *
+ * Resolution is intentionally dependency-free string/path math so it can be
+ * unit-tested without a Vite server or filesystem. It targets the modern
+ * standalone bootstrap shape (`bootstrapApplication(AppComponent, …)`),
+ * which is what `main.ts` uses; it degrades gracefully to `null` for shapes
+ * it can't statically resolve (e.g. NgModule `bootstrap: [...]`), in which
+ * case callers keep their existing behavior.
+ */
+export interface BootstrapRootComponent {
+    /**
+     * Extensionless, project-relative POSIX path with a leading slash —
+     * e.g. `/src/app/app.component`. Comparisons are always extensionless so
+     * a `.html` template edit and its `.ts` component resolve to the same key.
+     */
+    moduleRel: string;
+    /**
+     * The class name passed to `bootstrapApplication(...)` (best-effort,
+     * resolved back to the imported binding name when aliased). Used as a
+     * secondary match signal for Analog ids whose path base differs from the
+     * project root.
+     */
+    className: string;
+}
+/**
+ * Normalizes any project-relative path to a leading-slash, extensionless
+ * POSIX key suitable for equality comparison between a `.html`/`.ts` edit
+ * and the resolved root component.
+ */
+export declare function toExtensionlessModuleRel(rel: string): string;
+/** True when two project-relative paths refer to the same module (ignoring extension). */
+export declare function isSameAngularModuleRel(a: string | null | undefined, b: string | null | undefined): boolean;
+/**
+ * Resolves the bootstrap root component from a dev-server entry module's
+ * source. Returns `null` when the bootstrap shape can't be statically
+ * resolved (callers should then keep their default behavior).
+ */
+export declare function resolveBootstrapRootComponent(options: {
+    entrySource: string;
+    entryRel: string;
+    appRootRel?: string;
+}): BootstrapRootComponent | null;
+/**
+ * Decodes Analog's `angular:component-update` payload `id`
+ * (`encodeURIComponent(relativePath + '@' + className)`) into a normalized,
+ * extensionless module rel plus the class name, so the bridge can compare it
+ * against the resolved root component. Returns `null` for empty/invalid ids.
+ */
+export declare function decodeAngularComponentUpdateId(id: unknown): {
+    moduleRel: string;
+    className: string;
+} | null;
+/**
+ * True when an Analog `angular:component-update` `id` targets the resolved
+ * root component — matched by module path first (robust to class-name
+ * collisions), then by class name as a fallback.
+ */
+export declare function isAngularRootComponentUpdate(root: BootstrapRootComponent | null | undefined, id: unknown): boolean;