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

package/hmr/server/websocket-css-hot-update.d.ts

@@ -0,0 +1,33 @@
+export interface CollectCssHotUpdatePathsOptions {
+    /** Absolute path of the file the watcher saw change. */
+    file: string;
+    /** Vite dev server `config.root` (project root for the NS app). */
+    root: string;
+    /** `nativescript.config#appPath` value. Defaults to `'src'`. */
+    appRootDir?: string;
+    /**
+     * Absolute path to the project's primary CSS entry
+     * (`<root>/<appRootDir>/app.css`). Required to broadcast for
+     * out-of-scope CSS saves — workspace deps `@import`'d from
+     * `app.css` invalidate the `virtual:ns-app-css` module, which has
+     * no real `.file` to broadcast on its own.
+     */
+    appEntryCss?: string | null;
+}
+/**
+ * Compute the root-relative POSIX path to broadcast in `ns:css-updates`
+ * for a given CSS hot-update.
+ *
+ * - **In-scope CSS edit** (`<root>/src|core|<appRootDir>/...css`):
+ *   broadcast that file's path.
+ * - **Out-of-scope CSS edit** (workspace dep `@import`'d via
+ *   `app.css`): broadcast `appEntryCss`. The runtime fetches
+ *   `app.css?direct=1`, Vite re-runs PostCSS through the `@import`
+ *   chain, and the merged CSS lands.
+ *
+ * NS only ever fetches the entry CSS at runtime, so a single
+ * `appEntryCss` broadcast covers every workspace-dep CSS save —
+ * regardless of how deep the `@import` chain goes. Returns `[]` for
+ * non-CSS files or when no broadcast target is available.
+ */
+export declare function collectCssHotUpdatePaths(options: CollectCssHotUpdatePathsOptions): string[];

package/hmr/server/websocket-css-hot-update.js

@@ -0,0 +1,65 @@
+import path from 'path';
+const CSS_EXTENSION = /\.css(?:[?#].*)?$/i;
+function toPosix(value) {
+    return value.replace(/\\/g, '/');
+}
+function stripQuery(value) {
+    const idx = value.search(/[?#]/);
+    return idx === -1 ? value : value.slice(0, idx);
+}
+function isInProjectScope(absPath, root, appRootDir) {
+    if (!absPath || !root)
+        return false;
+    const absPosix = stripQuery(toPosix(absPath));
+    const rootPosix = toPosix(root).replace(/\/$/, '');
+    const dirs = [`${rootPosix}/src`, `${rootPosix}/core`];
+    if (appRootDir && appRootDir !== 'src') {
+        dirs.push(`${rootPosix}/${appRootDir}`);
+    }
+    return dirs.some((dir) => absPosix === dir || absPosix.startsWith(`${dir}/`));
+}
+function toRootRelative(absPath, root) {
+    if (!absPath || !root)
+        return null;
+    const cleaned = stripQuery(toPosix(absPath));
+    const rootPosix = toPosix(root).replace(/\/$/, '');
+    if (cleaned !== rootPosix && !cleaned.startsWith(`${rootPosix}/`)) {
+        return null;
+    }
+    const rel = path.posix.normalize(path.posix.relative(rootPosix, cleaned));
+    if (!rel || rel === '.' || rel.startsWith('..'))
+        return null;
+    return rel.startsWith('/') ? rel : `/${rel}`;
+}
+/**
+ * Compute the root-relative POSIX path to broadcast in `ns:css-updates`
+ * for a given CSS hot-update.
+ *
+ * - **In-scope CSS edit** (`<root>/src|core|<appRootDir>/...css`):
+ *   broadcast that file's path.
+ * - **Out-of-scope CSS edit** (workspace dep `@import`'d via
+ *   `app.css`): broadcast `appEntryCss`. The runtime fetches
+ *   `app.css?direct=1`, Vite re-runs PostCSS through the `@import`
+ *   chain, and the merged CSS lands.
+ *
+ * NS only ever fetches the entry CSS at runtime, so a single
+ * `appEntryCss` broadcast covers every workspace-dep CSS save —
+ * regardless of how deep the `@import` chain goes. Returns `[]` for
+ * non-CSS files or when no broadcast target is available.
+ */
+export function collectCssHotUpdatePaths(options) {
+    const { file, root, appRootDir, appEntryCss } = options;
+    if (!file || !root)
+        return [];
+    if (!CSS_EXTENSION.test(file))
+        return [];
+    if (isInProjectScope(file, root, appRootDir)) {
+        const rel = toRootRelative(file, root);
+        return rel ? [rel] : [];
+    }
+    if (!appEntryCss)
+        return [];
+    const rel = toRootRelative(appEntryCss, root);
+    return rel ? [rel] : [];
+}
+//# sourceMappingURL=websocket-css-hot-update.js.map

package/hmr/server/websocket-css-hot-update.js.map

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

package/hmr/server/websocket-device-transform.d.ts

@@ -0,0 +1,3 @@
+export { processCodeForDevice, cleanCode, collectImportDependencies } from './process-code-for-device.js';
+export { rewriteImports, prepareAngularEntryForDevice } from './rewrite-imports.js';
+export { shouldRemapImport } from './device-transform-helpers.js';

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

@@ -0,0 +1,7 @@
+// Public entry point for the device code-transform subsystem (the HMR plugin's
+// hot path). The implementation lives in three focused modules; consumers and
+// spec suites import the subsystem's surface from here.
+export { processCodeForDevice, cleanCode, collectImportDependencies } from './process-code-for-device.js';
+export { rewriteImports, prepareAngularEntryForDevice } from './rewrite-imports.js';
+export { shouldRemapImport } from './device-transform-helpers.js';
+//# sourceMappingURL=websocket-device-transform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-device-transform.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-device-transform.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,wDAAwD;AACxD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/hmr/server/websocket-graph-upsert.d.ts

@@ -4,3 +4,18 @@ export declare function classifyGraphUpsert(existing: {
     deps: string[];
 } | undefined, nextHash: string, nextDeps: string[]): GraphUpsertClassification;
 export declare function shouldBroadcastGraphUpsertDelta(classification: GraphUpsertClassification, emitDeltaOnInsert?: boolean, broadcastEnabled?: boolean): boolean;
+/**
+ * Decide whether an upsert should advance the shared graphVersion
+ * counter. Serve-time warm-ups (and the background initial-graph walk) pass
+ * `bumpVersion: false` so graphVersion stays stable during cold boot — that
+ * stability is what lets the dynamic-import helper tag every first-session
+ * URL with a consistent `v1` instead of drifting between `live`, `v12`,
+ * `v433`... (which would produce double-loaded modules on iOS HTTP ESM).
+ * Real live edits (handleHotUpdate and framework hot-update handlers) leave
+ * `bumpVersion` unset or true and advance the counter as before.
+ *
+ * The helper also treats `unchanged` classifications as no-op: they bypass
+ * the graph set entirely in upsertGraphModule, so the version must not
+ * advance for them either.
+ */
+export declare function shouldBumpGraphVersion(classification: GraphUpsertClassification, bumpVersion?: boolean): boolean;

package/hmr/server/websocket-graph-upsert.js

@@ -10,4 +10,24 @@ export function classifyGraphUpsert(existing, nextHash, nextDeps) {
 export function shouldBroadcastGraphUpsertDelta(classification, emitDeltaOnInsert = false, broadcastEnabled = true) {
     return broadcastEnabled && (classification === 'changed' || (classification === 'inserted' && emitDeltaOnInsert));
 }
+/**
+ * Decide whether an upsert should advance the shared graphVersion
+ * counter. Serve-time warm-ups (and the background initial-graph walk) pass
+ * `bumpVersion: false` so graphVersion stays stable during cold boot — that
+ * stability is what lets the dynamic-import helper tag every first-session
+ * URL with a consistent `v1` instead of drifting between `live`, `v12`,
+ * `v433`... (which would produce double-loaded modules on iOS HTTP ESM).
+ * Real live edits (handleHotUpdate and framework hot-update handlers) leave
+ * `bumpVersion` unset or true and advance the counter as before.
+ *
+ * The helper also treats `unchanged` classifications as no-op: they bypass
+ * the graph set entirely in upsertGraphModule, so the version must not
+ * advance for them either.
+ */
+export function shouldBumpGraphVersion(classification, bumpVersion = true) {
+    if (classification === 'unchanged') {
+        return false;
+    }
+    return bumpVersion !== false;
+}
 //# sourceMappingURL=websocket-graph-upsert.js.map

package/hmr/server/websocket-graph-upsert.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-graph-upsert.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-graph-upsert.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,QAAsD,EAAE,QAAgB,EAAE,QAAkB;IAC/H,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChI,OAAO,WAAW,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,cAAyC,EAAE,oBAA6B,KAAK,EAAE,mBAA4B,IAAI;IAC9J,OAAO,gBAAgB,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,cAAc,KAAK,UAAU,IAAI,iBAAiB,CAAC,CAAC,CAAC;AACnH,CAAC"}
+{"version":3,"file":"websocket-graph-upsert.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-graph-upsert.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,QAAsD,EAAE,QAAgB,EAAE,QAAkB;IAC/H,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChI,OAAO,WAAW,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,cAAyC,EAAE,oBAA6B,KAAK,EAAE,mBAA4B,IAAI;IAC9J,OAAO,gBAAgB,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,cAAc,KAAK,UAAU,IAAI,iBAAiB,CAAC,CAAC,CAAC;AACnH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,cAAyC,EAAE,cAAuB,IAAI;IAC5G,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,WAAW,KAAK,KAAK,CAAC;AAC9B,CAAC"}

package/hmr/server/websocket-hmr-pending.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Early "pending" notification for HMR.
+ *
+ * When `handleHotUpdate(ctx)` first fires for a save event, the server
+ * spends 7–200ms doing graph upserts, transforms and dependency
+ * analysis BEFORE broadcasting `ns:angular-update` (or
+ * `ns:css-updates`). During that window the client has no idea a
+ * change is in flight, so the HMR-applying overlay only appears at
+ * the tail end of the cycle and the user perceives the dev loop as
+ * laggy.
+ *
+ * `ns:hmr-pending` is broadcast at the very start of `handleHotUpdate`
+ * with just the file path + classified kind. The client reacts by
+ * showing the 'received' overlay frame immediately. The authoritative
+ * payload (`ns:angular-update` / `ns:css-updates`) follows once the
+ * server is ready and walks the rest of the stage progression.
+ *
+ * This module is intentionally a pure helper so the message shape and
+ * narrowing rules can be verified without spinning up a Vite dev
+ * server.
+ */
+import type { HmrPendingKind, HmrPendingMessage } from '../shared/protocol.js';
+export type { HmrPendingKind, HmrPendingMessage };
+export declare function createHmrPendingMessage(input: {
+    origin: string;
+    path: string;
+    kind: string;
+    timestamp: number;
+}): HmrPendingMessage;
+/**
+ * Parser used by the client to identify a pending message regardless of
+ * which framework is active. We accept the message only when every
+ * expected field is present and well-formed — this guards against
+ * accidental matches on legacy server payloads or developer-written
+ * mocks during tests.
+ */
+export declare function isHmrPendingMessage(value: unknown): value is HmrPendingMessage;

package/hmr/server/websocket-hmr-pending.js

@@ -0,0 +1,55 @@
+/**
+ * Early "pending" notification for HMR.
+ *
+ * When `handleHotUpdate(ctx)` first fires for a save event, the server
+ * spends 7–200ms doing graph upserts, transforms and dependency
+ * analysis BEFORE broadcasting `ns:angular-update` (or
+ * `ns:css-updates`). During that window the client has no idea a
+ * change is in flight, so the HMR-applying overlay only appears at
+ * the tail end of the cycle and the user perceives the dev loop as
+ * laggy.
+ *
+ * `ns:hmr-pending` is broadcast at the very start of `handleHotUpdate`
+ * with just the file path + classified kind. The client reacts by
+ * showing the 'received' overlay frame immediately. The authoritative
+ * payload (`ns:angular-update` / `ns:css-updates`) follows once the
+ * server is ready and walks the rest of the stage progression.
+ *
+ * This module is intentionally a pure helper so the message shape and
+ * narrowing rules can be verified without spinning up a Vite dev
+ * server.
+ */
+export function createHmrPendingMessage(input) {
+    const allowed = ['ts', 'css', 'html', 'unknown'];
+    const kind = allowed.includes(input.kind || '') ? input.kind : 'unknown';
+    return {
+        type: 'ns:hmr-pending',
+        origin: typeof input.origin === 'string' ? input.origin : '',
+        path: typeof input.path === 'string' ? input.path : '',
+        kind,
+        timestamp: typeof input.timestamp === 'number' && Number.isFinite(input.timestamp) ? input.timestamp : 0,
+    };
+}
+/**
+ * Parser used by the client to identify a pending message regardless of
+ * which framework is active. We accept the message only when every
+ * expected field is present and well-formed — this guards against
+ * accidental matches on legacy server payloads or developer-written
+ * mocks during tests.
+ */
+export function isHmrPendingMessage(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (v.type !== 'ns:hmr-pending')
+        return false;
+    if (typeof v.path !== 'string' || !v.path)
+        return false;
+    if (typeof v.timestamp !== 'number' || !Number.isFinite(v.timestamp))
+        return false;
+    const allowed = ['ts', 'css', 'html', 'unknown'];
+    if (!allowed.includes(v.kind || ''))
+        return false;
+    return true;
+}
+//# sourceMappingURL=websocket-hmr-pending.js.map

package/hmr/server/websocket-hmr-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-hmr-pending.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-hmr-pending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,MAAM,UAAU,uBAAuB,CAAC,KAAwE;IAC/G,MAAM,OAAO,GAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,IAAI,GAAI,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,IAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IACpH,OAAO;QACN,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC5D,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACtD,IAAI;QACJ,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;KACxG,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAmC,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IACnF,MAAM,OAAO,GAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnE,IAAI,CAAE,OAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,OAAO,IAAI,CAAC;AACb,CAAC"}

package/hmr/server/websocket-hot-update.d.ts

@@ -0,0 +1,77 @@
+import type { HmrContext } from 'vite';
+import type { WebSocketServer } from 'ws';
+import type { FrameworkServerStrategy } from './framework-strategy.js';
+import type { HmrModuleGraph } from './hmr-module-graph.js';
+import type { SharedTransformRequestRunner } from './shared-transform-request.js';
+import type { BootstrapRootComponent } from '../frameworks/angular/server/angular-root-component.js';
+/**
+ * Dependencies injected into each strategy's `handleHotUpdate` (and the shared
+ * {@link runHotUpdatePrologue} it runs first). These hold per-server instance
+ * state (`wss`, `moduleGraph`, the file maps, `sharedTransformRequest`) or are
+ * plugin-closure accessors. Pure transform helpers (`cleanCode`,
+ * `rewriteImports`, `processSfcCode`, `collectImportDependencies`) are NOT on the
+ * context — the strategies that need them import them directly from
+ * `websocket-device-transform.ts`. `getServerOrigin` is likewise imported
+ * directly here from `server-origin.ts` (spy via the module in tests).
+ */
+export interface NsHotUpdateContext {
+    wss: WebSocketServer | null;
+    moduleGraph: HmrModuleGraph;
+    strategy: FrameworkServerStrategy;
+    verbose: boolean;
+    sfcFileMap: Map<string, string>;
+    depFileMap: Map<string, string>;
+    sharedTransformRequest: SharedTransformRequestRunner;
+    getHmrSourceRootsCached: () => string[];
+    getBootstrapEntryRelPath: () => string;
+    isSocketClientOpen: (client: {
+        readyState?: number;
+        OPEN?: number;
+    } | null | undefined) => boolean;
+    getHmrSocketRole: (client: {
+        __nsHmrClientRole?: string;
+    } | null | undefined) => string;
+    shouldRemapImport: (spec: string) => boolean;
+    rememberAngularReloadSuppression: (root: string, file: string, ttlMs?: number) => void;
+    /**
+     * Resolves the Angular bootstrap (root) component, or `null` when it
+     * can't be statically determined. Used to force root-component template
+     * edits through the reboot path instead of Analog's in-place update,
+     * which is destructive for the root view (see {@link BootstrapRootComponent}).
+     */
+    getRootComponentIdentity: () => BootstrapRootComponent | null;
+    getGraphInitialPopulationPromise: () => Promise<void> | null;
+    appRootDir: string;
+}
+/** Always-on per-update timing + diagnostics, mutated in place across the prologue and the framework tail. */
+export interface HmrUpdateMetrics {
+    file: string;
+    kind: string;
+    t0: number;
+    tAfterAwait: number;
+    tAfterFramework: number;
+    tEnd: number;
+    invalidated: number;
+    recipients: number;
+    narrowed: boolean | undefined;
+    emitted: boolean;
+}
+/** Per-invocation locals computed by {@link runHotUpdatePrologue} and consumed by the per-flavor tail. */
+export interface HotUpdatePrologueState {
+    root: string;
+    updateRel: string;
+    metrics: HmrUpdateMetrics;
+    emitSummary: () => void;
+}
+/**
+ * Shared, framework-agnostic prologue for every strategy's `handleHotUpdate`:
+ * scope gating, update-metrics setup, the `ns:hmr-pending` broadcast, awaiting the
+ * initial graph population, the common module-graph upsert, CSS hot-update +
+ * Tailwind content-CSS broadcast, and the project-scope filter. Returns `null`
+ * when one of those steps fully handles the change (every such path resolves to
+ * Vite's `undefined` result, so the caller just returns), otherwise the
+ * per-invocation {@link HotUpdatePrologueState} (`root`, `updateRel`, the live
+ * `metrics` object, the idempotent `emitSummary`) the per-flavor tail consumes.
+ * Exported so per-flavor strategies can own `prologue + their tail`.
+ */
+export declare function runHotUpdatePrologue(ctx: HmrContext, deps: NsHotUpdateContext): Promise<HotUpdatePrologueState | null>;