@nativescript/vite 8.0.0-beta.0 → 8.0.0-rc.0

package/hmr/server/import-map.js

@@ -0,0 +1,294 @@
+/**
+ * Import Map Generator for NativeScript HMR
+ *
+ * Generates an import map that the iOS/Android runtime consumes via
+ * ns:module configureLoader(). This is the single source of truth for module
+ * resolution on the device.
+ *
+ * Resolution strategy:
+ *   Every bare npm specifier → HTTP URL (`/ns/m/node_modules/<pkg>`).
+ *     Package roots in the vendor collection get EXACT entries whose served
+ *     body is a deps-bundle shim (see deps-bundle.ts), so "many specifiers,
+ *     one instance" holds via the single bundle realm — no custom URL scheme.
+ *   @nativescript/core → HTTP bridge URL (/ns/core)
+ *   Trailing-slash prefix entries cover subpath imports
+ *     (e.g. @nativescript/tanstack-router/solid) for every package.
+ *
+ * The runtime matches map keys literally: it reverse-engineers none of Vite's
+ * rewrites (`/node_modules/.vite/deps/solid-js.js?v=…`, `/@id/…`, `/@fs/…`).
+ * Every specifier form that reaches the device must therefore either be a key
+ * in this map or be rewritten by the server before it is served — the /ns/m
+ * pipeline (`processCodeForDevice`) turns prebundled-dep paths back into bare
+ * ids and resolves package-internal paths to full `/ns/m/node_modules/…` URLs.
+ */
+import { getVendorManifest, listVendorModules } from '../shared/vendor/registry.js';
+import { readFileSync, readdirSync, existsSync, statSync } from 'fs';
+import { resolve, join } from 'path';
+import { getProjectRootPath } from '../../helpers/project.js';
+import { buildCoreUrl } from '../../helpers/ns-core-url.js';
+import { getNodeBuiltinImportMapEntries } from './node-builtins-route.js';
+const OMIT_DEVICE_IMPORT_MAP_PACKAGES = new Set(['typescript', 'ts-node', 'esbuild', 'prettier', 'webpack', 'vite', '@nativescript/android', '@nativescript/ios', '@nativescript/visionos', '@nativescript/webpack', '@nativescript/types']);
+const OMIT_DEVICE_IMPORT_MAP_PREFIXES = ['@types/', '@babel/', 'babel-', '@rollup/', '@vitejs/', 'vite-plugin-', '@angular-devkit/', '@angular/build', '@analogjs/'];
+const PREFIX_ONLY_DEVICE_IMPORT_MAP_PACKAGES = new Set(['@nativescript/vite']);
+function getDeviceImportMapExposure(name) {
+    if (PREFIX_ONLY_DEVICE_IMPORT_MAP_PACKAGES.has(name)) {
+        return 'prefix-only';
+    }
+    if (OMIT_DEVICE_IMPORT_MAP_PACKAGES.has(name)) {
+        return 'omit';
+    }
+    for (const prefix of OMIT_DEVICE_IMPORT_MAP_PREFIXES) {
+        if (name.startsWith(prefix)) {
+            return 'omit';
+        }
+    }
+    return 'full';
+}
+/**
+ * Generate an import map from the current vendor manifest.
+ *
+ * Vendor package roots map to `${origin}/ns/m/node_modules/<pkg>` — served
+ * as deps-bundle shims (thin re-exports out of `__NS_DEPS_MODULES__`, the
+ * single-evaluation bundle realm), so every specifier of a package resolves
+ * to one instance. Manifest aliases collapse onto their canonical package's
+ * URL, preserving the "many specifiers, one instance" semantics.
+ *
+ * IMPORTANT: Vendor entries are EXACT only (no trailing-slash prefixes).
+ * Subpath imports like solid-js/store or @nativescript/tanstack-router/solid
+ * are separate entry points with different exports — they must NOT resolve
+ * to the package root. They fall through to the HTTP trailing-slash prefix
+ * entries from discoverInstalledPackages().
+ *
+ * @nativescript/core is mapped to the HTTP bridge endpoint.
+ * Everything else falls through to the runtime's normal resolution.
+ */
+export function generateImportMap(options) {
+    const { origin, strategy, extraEntries } = options;
+    const manifest = getVendorManifest();
+    const imports = {};
+    if (manifest) {
+        // EXACT entries only for vendor roots — subpaths resolve via the
+        // trailing-slash HTTP prefixes added below.
+        //
+        // IMPORTANT: `@nativescript/core` and any `@nativescript/core/<sub>` are
+        // deliberately routed through the HTTP bridge (`${origin}/ns/core/...`),
+        // never through `/ns/m/node_modules/`. The core bridge is the canonical
+        // source for every `Application`, `View`, `Frame`, etc. instance —
+        // a second copy of core produces the classic
+        // `vendorApplicationSame: false` realm split (different
+        // `globalThis.Application` than the one the iOS/Android hooks patched)
+        // and HMR placeholder finalize stalls. The dev server normalizes
+        // platform suffixes (see `normalizeCoreSub` in `ns-core-url.ts`) so
+        // `@nativescript/core/ui/frame/activity.android` → bridge URL
+        // `/ns/core/ui/frame/activity.android` → served from the
+        // platform-specific `.android.ts` source.
+        const vendorModules = listVendorModules();
+        for (const specifier of vendorModules) {
+            if (specifier === '@nativescript/core' || specifier.startsWith('@nativescript/core/')) {
+                continue;
+            }
+            imports[specifier] = `${origin}/ns/m/node_modules/${specifier}`;
+        }
+        // Map aliases from the manifest (e.g., "solid-js/web" → solid-js's URL)
+        if (manifest.aliases) {
+            for (const [alias, canonical] of Object.entries(manifest.aliases)) {
+                // Same single-realm reason as above.
+                if (alias === '@nativescript/core' || alias.startsWith('@nativescript/core/')) {
+                    continue;
+                }
+                if (!imports[alias] && imports[canonical]) {
+                    imports[alias] = imports[canonical];
+                }
+            }
+        }
+    }
+    // @nativescript/core → bridge endpoint (canonical URL generator).
+    // The trailing-slash entry intentionally uses the same generator so
+    // subpath imports resolve via `${origin}/ns/core/<sub>`.
+    imports['@nativescript/core'] = buildCoreUrl(origin);
+    imports['@nativescript/core/'] = `${buildCoreUrl(origin)}/`;
+    // `node:` builtins → dev-served shims (`/ns/node/<name>`, see
+    // node-builtins-route.ts). During a dev session these map entries
+    // shadow the runtime's baked-in polyfill branch, keeping the shim
+    // vocabulary server-owned; outside dev sessions the native fallback
+    // still applies.
+    Object.assign(imports, getNodeBuiltinImportMapEntries(origin));
+    // Add framework-specific entries (owned by the active strategy). Merge
+    // CONDITIONALLY (existing entries win) so Vue's vendor entries (set above)
+    // take precedence over the hook's fallback targets, while Solid's
+    // `solid-js` (externalized from vendor, so unset here) is added.
+    // Insertion order is significant for the generated map.
+    const frameworkEntries = strategy?.importMapEntries?.(origin);
+    if (frameworkEntries) {
+        for (const [specifier, target] of Object.entries(frameworkEntries)) {
+            if (!imports[specifier]) {
+                imports[specifier] = target;
+            }
+        }
+    }
+    // Scan installed packages and add HTTP URL entries for ALL packages
+    // (including vendor ones for their subpath imports).
+    discoverInstalledPackages(imports, origin);
+    // Merge extra entries (user-provided or from framework strategies)
+    if (extraEntries) {
+        Object.assign(imports, extraEntries);
+    }
+    return { imports };
+}
+/**
+ * Get volatile URL patterns for the current framework.
+ * These patterns tell the runtime to always re-fetch matching URLs
+ * instead of using cached modules.
+ */
+export function getVolatilePatterns(strategy) {
+    const patterns = [];
+    // Version query params (used by HMR for cache busting)
+    patterns.push('?v=');
+    patterns.push('&v=');
+    // Framework-specific volatile patterns (owned by the active strategy —
+    // e.g. Angular's `/@ng/component`, whose per-save `t` param would
+    // otherwise leave one stale registry entry behind per save).
+    const frameworkPatterns = strategy?.volatilePatterns?.();
+    if (frameworkPatterns) {
+        patterns.push(...frameworkPatterns);
+    }
+    return patterns;
+}
+/**
+ * The URL canonicalization vocabulary handed to the runtime via
+ * `configureLoader({ canonicalization })`. The runtime owns the *mechanism*
+ * (fragment strip, cache-buster param drop, param sort — it keys the module
+ * registry inside the engine's synchronous resolve walk); this server owns
+ * the *vocabulary*, because every name in it is a route this server defines:
+ *
+ * - `stripParams`: Vite's `import` marker and `t`/`v` cache stamps — pure
+ *   cache busters that must not create distinct module identities.
+ * - `forPathPrefixes`: the dev endpoints under which query normalization is
+ *   safe. Everything else (public/remote URLs) keeps its query verbatim,
+ *   since for general HTTP modules the query can be identity (auth,
+ *   content versioning, routing).
+ * - `preserveQueryFor`: strategy-owned paths whose query IS the module
+ *   identity (e.g. Angular's `/@ng/component?c=<id>&t=<ts>` — each `t` is a
+ *   distinct metadata recompile).
+ */
+export function getCanonicalization(strategy) {
+    return {
+        stripParams: ['t', 'v', 'import'],
+        forPathPrefixes: ['/ns/', '/node_modules/.vite/', '/@id/', '/@fs/'],
+        preserveQueryFor: strategy?.preserveQueryPaths?.() ?? [],
+    };
+}
+/**
+ * Serialize the import map + volatile patterns + canonicalization vocabulary
+ * into the config object that ns:module configureLoader() expects.
+ */
+export function buildRuntimeConfig(options) {
+    const importMap = generateImportMap(options);
+    const volatilePatterns = getVolatilePatterns(options.strategy);
+    const canonicalization = getCanonicalization(options.strategy);
+    return {
+        importMap: JSON.stringify(importMap),
+        volatilePatterns,
+        canonicalization,
+    };
+}
+/**
+ * Scan the project's node_modules to discover ALL installed packages and
+ * add import map entries. Vendor packages get only trailing-slash prefix
+ * entries (their exact entries were set above). Non-vendor packages get
+ * both exact and trailing-slash entries.
+ *
+ * The trailing-slash prefix entries are critical: they enable subpath imports
+ * like solid-js/store or @nativescript/tanstack-router/solid to resolve via
+ * HTTP, even when the root package has a deps-shim exact entry.
+ */
+function discoverInstalledPackages(imports, origin) {
+    let projectRoot;
+    try {
+        projectRoot = getProjectRootPath();
+    }
+    catch {
+        return;
+    }
+    const nodeModulesDir = resolve(projectRoot, 'node_modules');
+    if (!existsSync(nodeModulesDir))
+        return;
+    const addPackage = (name) => {
+        const exposure = getDeviceImportMapExposure(name);
+        if (exposure === 'omit')
+            return;
+        // Add exact entry only if not already mapped (vendor packages already have exact entries)
+        if (exposure === 'full' && !imports[name]) {
+            imports[name] = `${origin}/ns/m/node_modules/${name}`;
+        }
+        // ALWAYS add trailing-slash prefix for HTTP subpath resolution,
+        // even for vendor packages. The vendor bundle only covers the root
+        // entry point — subpaths like solid-js/store or @nativescript/tanstack-router/solid
+        // are separate entry points that must resolve via HTTP.
+        if (!imports[name + '/']) {
+            imports[name + '/'] = `${origin}/ns/m/node_modules/${name}/`;
+        }
+    };
+    // Replay the (cheap, in-memory) addPackage step for every installed package
+    // name. The names themselves come from a per-session cache so the directory
+    // sweep below runs once per dev server, not on every `/ns/import-map.json`
+    // request (a hot, per-boot route).
+    for (const name of getInstalledPackageNames(nodeModulesDir)) {
+        addPackage(name);
+    }
+}
+// Cache the discovered package-name list per node_modules dir, invalidated when
+// the directory's mtime changes (an install/remove of a top-level entry). Avoids
+// a full `readdirSync` sweep (+ per-scope readdir) on every import-map request.
+let installedPackageNamesCache = null;
+function getInstalledPackageNames(nodeModulesDir) {
+    // mtime guards the cache; if it can't be read (e.g. a mocked fs in tests),
+    // fall back to sweeping every call (original behavior) rather than caching.
+    let mtimeMs = null;
+    try {
+        mtimeMs = statSync(nodeModulesDir).mtimeMs;
+    }
+    catch {
+        mtimeMs = null;
+    }
+    if (mtimeMs !== null && installedPackageNamesCache && installedPackageNamesCache.dir === nodeModulesDir && installedPackageNamesCache.mtimeMs === mtimeMs) {
+        return installedPackageNamesCache.names;
+    }
+    const names = [];
+    try {
+        const entries = readdirSync(nodeModulesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory() && !entry.isSymbolicLink())
+                continue;
+            const name = entry.name;
+            if (name.startsWith('.'))
+                continue;
+            if (name.startsWith('@')) {
+                // Scoped packages: read @scope/ directory
+                const scopeDir = join(nodeModulesDir, name);
+                try {
+                    const scopeEntries = readdirSync(scopeDir, { withFileTypes: true });
+                    for (const scopeEntry of scopeEntries) {
+                        if (!scopeEntry.isDirectory() && !scopeEntry.isSymbolicLink())
+                            continue;
+                        if (scopeEntry.name.startsWith('.'))
+                            continue;
+                        names.push(`${name}/${scopeEntry.name}`);
+                    }
+                }
+                catch { }
+            }
+            else {
+                names.push(name);
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+    if (mtimeMs !== null) {
+        installedPackageNamesCache = { dir: nodeModulesDir, mtimeMs, names };
+    }
+    return names;
+}
+//# sourceMappingURL=import-map.js.map

package/hmr/server/import-map.js.map

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

package/hmr/server/index.d.ts

@@ -1,5 +1,6 @@
+import type { NsDevPlatform } from '../shared/runtime/browser-runtime-contract.js';
 export declare function getHMRPlugins(opts: {
-    platform: string;
+    platform: NsDevPlatform;
     flavor: string;
     verbose: boolean;
 }): import("vite").Plugin<any>[];

package/hmr/server/index.js

@@ -1,22 +1,13 @@
 import { nsHmrClientVitePlugin } from './vite-plugin.js';
-import { hmrWebSocketVue, hmrWebSocketAngular, hmrWebSocketSolid, hmrWebSocketTypescript } from './websocket.js';
+import { hmrWebSocketPluginForFlavor } from './websocket.js';
 export function getHMRPlugins(opts) {
     const plugins = [nsHmrClientVitePlugin(opts)];
-    switch (opts.flavor) {
-        case 'vue':
-            plugins.push(hmrWebSocketVue(opts));
-            break;
-        case 'react':
-            break;
-        case 'angular':
-            plugins.push(hmrWebSocketAngular(opts));
-            break;
-        case 'typescript':
-            plugins.push(hmrWebSocketTypescript(opts));
-            break;
-        case 'solid':
-            plugins.push(hmrWebSocketSolid(opts));
-            break;
+    // The server-side HMR WebSocket plugin is selected from STRATEGY_REGISTRY by
+    // flavor. Flavors without a registered server strategy (e.g. `react`) ship
+    // only the client plugin above — no per-flavor switch or no-op special case.
+    const frameworkPlugin = hmrWebSocketPluginForFlavor(opts.flavor, opts);
+    if (frameworkPlugin) {
+        plugins.push(frameworkPlugin);
     }
     return plugins;
 }

package/hmr/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEjH,MAAM,UAAU,aAAa,CAAC,IAA4D;IACzF,MAAM,OAAO,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,KAAK;YACT,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,MAAM;QACP,KAAK,OAAO;YACX,MAAM;QACP,KAAK,SAAS;YACb,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC,MAAM;QACP,KAAK,YAAY;YAChB,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,MAAM;QACP,KAAK,OAAO;YACX,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YACtC,MAAM;IACR,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,UAAU,aAAa,CAAC,IAAmE;IAChG,MAAM,OAAO,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,eAAe,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvE,IAAI,eAAe,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/hmr/server/node-builtins-route.d.ts

@@ -0,0 +1,12 @@
+import type { ViteDevServer } from 'vite';
+/**
+ * Exact import-map entries mapping every `node:<name>` specifier to this
+ * route. Exact (not trailing-slash prefix) entries for two reasons: the
+ * import-map spec reserves trailing-slash keys for path prefixes, and the
+ * native resolver only intercepts `node:`-prefixed specifiers — bare 'url'
+ * must keep resolving to the npm package of that name.
+ */
+export declare function getNodeBuiltinImportMapEntries(origin: string): Record<string, string>;
+/** The module body served for `node:<name>` during a dev session. */
+export declare function buildNodeBuiltinShimModule(name: string): string;
+export declare function registerNodeBuiltinsRoute(server: ViteDevServer): void;

package/hmr/server/node-builtins-route.js

@@ -0,0 +1,86 @@
+import { builtinModules } from 'node:module';
+import { setDeviceModuleHeaders } from './route-helpers.js';
+/**
+ * Dev-session shims for Node.js builtins: `GET /ns/node/<name>`.
+ *
+ * The device import map carries an exact entry for every `node:<name>`
+ * specifier (see `getNodeBuiltinImportMapEntries`), so during a dev session
+ * imports like `node:url` resolve through the map to this route BEFORE the
+ * native runtime's baked-in polyfill branch is reached. That keeps the
+ * shim *vocabulary and bodies* on the server (one place to grow/fix them)
+ * and leaves the native branch as the non-dev fallback only.
+ *
+ * Two shim shapes, mirroring the native fallback's semantics:
+ *   - `node:url` — a real shim: `fileURLToPath`/`pathToFileURL` plus
+ *     re-exports of the runtime's global `URL`/`URLSearchParams`.
+ *   - every other builtin — a warn-stub default export, so an accidental
+ *     `node:fs` import surfaces loudly in the console instead of crashing
+ *     resolution.
+ */
+const NODE_BUILTIN_ROUTE_PREFIX = '/ns/node/';
+// `builtinModules` lists unprefixed names ('url', 'fs', 'fs/promises', ...).
+// A Set for O(1) route validation.
+const nodeBuiltinNames = new Set(builtinModules.filter((name) => !name.startsWith('node:')));
+/**
+ * Exact import-map entries mapping every `node:<name>` specifier to this
+ * route. Exact (not trailing-slash prefix) entries for two reasons: the
+ * import-map spec reserves trailing-slash keys for path prefixes, and the
+ * native resolver only intercepts `node:`-prefixed specifiers — bare 'url'
+ * must keep resolving to the npm package of that name.
+ */
+export function getNodeBuiltinImportMapEntries(origin) {
+    const entries = {};
+    for (const name of nodeBuiltinNames) {
+        entries[`node:${name}`] = `${origin}${NODE_BUILTIN_ROUTE_PREFIX}${name}`;
+    }
+    return entries;
+}
+const URL_SHIM = `// Dev-session shim for node:url — served by the @nativescript/vite dev server.
+const _URL = globalThis.URL;
+const _URLSearchParams = globalThis.URLSearchParams;
+export { _URL as URL, _URLSearchParams as URLSearchParams };
+export function fileURLToPath(url) {
+  if (typeof url === 'string') {
+    if (url.startsWith('file://')) {
+      return decodeURIComponent(url.slice(7));
+    }
+    return url;
+  }
+  if (url && typeof url.href === 'string') {
+    return fileURLToPath(url.href);
+  }
+  throw new Error('Invalid URL');
+}
+export function pathToFileURL(path) {
+  const encoded = encodeURIComponent(path).replace(/%2F/g, '/');
+  return new _URL('file://' + encoded);
+}
+export default { URL: _URL, URLSearchParams: _URLSearchParams, fileURLToPath, pathToFileURL };
+`;
+/** The module body served for `node:<name>` during a dev session. */
+export function buildNodeBuiltinShimModule(name) {
+    if (name === 'url') {
+        return URL_SHIM;
+    }
+    const label = JSON.stringify(`node:${name}`);
+    return `// Dev-session warn-stub for ${name} — served by the @nativescript/vite dev server.\n` + `console.warn('[ns-vite] Node.js builtin ' + ${label} + ' is not available in the NativeScript runtime; serving an empty stub.');\n` + `export default {};\n`;
+}
+export function registerNodeBuiltinsRoute(server) {
+    server.middlewares.use((req, res, next) => {
+        const urlObj = new URL(req.url || '', 'http://localhost');
+        if (!urlObj.pathname.startsWith(NODE_BUILTIN_ROUTE_PREFIX))
+            return next();
+        const name = decodeURIComponent(urlObj.pathname.slice(NODE_BUILTIN_ROUTE_PREFIX.length));
+        if (!nodeBuiltinNames.has(name)) {
+            // Unknown name under /ns/node/ — not ours to serve; a 404 is more
+            // honest than a stub for a typo'd or future builtin.
+            res.statusCode = 404;
+            res.end(`// Unknown Node.js builtin: ${JSON.stringify(name)}\n`);
+            return;
+        }
+        setDeviceModuleHeaders(res);
+        res.statusCode = 200;
+        res.end(buildNodeBuiltinShimModule(name));
+    });
+}
+//# sourceMappingURL=node-builtins-route.js.map

package/hmr/server/node-builtins-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-builtins-route.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/node-builtins-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,yBAAyB,GAAG,WAAW,CAAC;AAE9C,6EAA6E;AAC7E,mCAAmC;AACnC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAErG;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAc;IAC5D,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACrC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,GAAG,MAAM,GAAG,yBAAyB,GAAG,IAAI,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACtD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,gCAAgC,IAAI,mDAAmD,GAAG,+CAA+C,KAAK,gFAAgF,GAAG,sBAAsB,CAAC;AAChQ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAqB;IAC9D,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC;YAAE,OAAO,IAAI,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,kEAAkE;YAClE,qDAAqD;YACrD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,OAAO;QACR,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC5B,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC"}