@analogjs/vite-plugin-angular 3.0.0-alpha.9 → 3.0.0-alpha.91

package/src/lib/utils/debug-harness.d.ts

@@ -0,0 +1,23 @@
+import type { Debugger } from "obug";
+export type DebugMode = "build" | "dev";
+export interface DebugModeOptions<S extends string = string> {
+	scopes?: boolean | S[];
+	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
+}
+export type DebugOption<S extends string = string> = boolean | S[] | DebugModeOptions<S> | DebugModeOptions<S>[];
+export interface DebugHarness<S extends string = string> {
+	applyDebugOption(debug: DebugOption<S> | undefined, workspaceRoot?: string): void;
+	activateDeferredDebug(command: "build" | "serve"): void;
+	/** @internal test-only reset */
+	_resetDeferredDebug(): void;
+}
+export declare function createDebugHarness<S extends string = string>(config: {
+	fallbackNamespace: string;
+	instanceGroups: Debugger[][];
+}): DebugHarness<S>;

package/src/lib/utils/debug-harness.js

@@ -0,0 +1,88 @@
+import { DEBUG_LOG_DIR, DEBUG_LOG_FILENAME, wrapInstancesForFileLog, wrapInstancesForScopedFileLog } from "./debug-log-file.js";
+import { join } from "node:path";
+import { enable } from "obug";
+//#region packages/vite-plugin-angular/src/lib/utils/debug-harness.ts
+/**
+* Duplicates of this file (keep in sync):
+*   packages/platform/src/lib/utils/debug-harness.ts
+*   packages/vite-plugin-angular/src/lib/utils/debug-harness.ts
+*/
+function resolveNamespaces(scopes, fallback) {
+	if (scopes === true || scopes === void 0) return fallback;
+	if (Array.isArray(scopes) && scopes.length) return scopes.join(",");
+	return null;
+}
+function extractLogFile(debug) {
+	if (typeof debug === "boolean") return false;
+	if (Array.isArray(debug)) {
+		if (debug.length === 0 || typeof debug[0] === "string") return false;
+		return debug.find((e) => !!e.logFile)?.logFile ?? false;
+	}
+	return debug.logFile ?? false;
+}
+function createDebugHarness(config) {
+	let pendingDebug = [];
+	function installFileWrappers(logFile, root) {
+		if (logFile === "scoped") {
+			const dirPath = join(root, DEBUG_LOG_DIR);
+			for (const group of config.instanceGroups) wrapInstancesForScopedFileLog(group, dirPath);
+		} else {
+			const filePath = join(root, DEBUG_LOG_DIR, DEBUG_LOG_FILENAME);
+			for (const group of config.instanceGroups) wrapInstancesForFileLog(group, filePath);
+		}
+	}
+	function applyEntry(entry, fallback, logFile, root) {
+		if (!entry.mode) {
+			const ns = resolveNamespaces(entry.scopes ?? true, fallback);
+			if (ns) enable(ns);
+			if (logFile) installFileWrappers(logFile, root);
+		} else pendingDebug.push({
+			entry,
+			logFile,
+			root
+		});
+	}
+	return {
+		applyDebugOption(debug, workspaceRoot) {
+			if (debug == null || debug === false) return;
+			const logFile = extractLogFile(debug);
+			const root = workspaceRoot ?? process.env["NX_WORKSPACE_ROOT"] ?? process.cwd();
+			if (typeof debug === "boolean") {
+				const ns = resolveNamespaces(debug, config.fallbackNamespace);
+				if (ns) enable(ns);
+				return;
+			}
+			if (Array.isArray(debug)) {
+				if (debug.length === 0) return;
+				if (typeof debug[0] === "string") {
+					const ns = debug.join(",");
+					if (ns) enable(ns);
+					return;
+				}
+				for (const entry of debug) {
+					const entryLogFile = entry.logFile ?? false;
+					applyEntry(entry, config.fallbackNamespace, entryLogFile || logFile, root);
+				}
+				return;
+			}
+			applyEntry(debug, config.fallbackNamespace, logFile, root);
+		},
+		activateDeferredDebug(command) {
+			if (pendingDebug.length === 0) return;
+			const currentMode = command === "serve" ? "dev" : "build";
+			for (const { entry, logFile, root } of pendingDebug) if (entry.mode === currentMode) {
+				const ns = resolveNamespaces(entry.scopes ?? true, config.fallbackNamespace);
+				if (ns) enable(ns);
+				if (logFile) installFileWrappers(logFile, root);
+			}
+			pendingDebug = [];
+		},
+		_resetDeferredDebug() {
+			pendingDebug = [];
+		}
+	};
+}
+//#endregion
+export { createDebugHarness };
+
+//# sourceMappingURL=debug-harness.js.map

package/src/lib/utils/debug-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-harness.js","names":[],"sources":["../../../../src/lib/utils/debug-harness.ts"],"sourcesContent":["/**\n * Duplicates of this file (keep in sync):\n *   packages/platform/src/lib/utils/debug-harness.ts\n *   packages/vite-plugin-angular/src/lib/utils/debug-harness.ts\n */\nimport { join } from 'node:path';\nimport { enable } from 'obug';\nimport type { Debugger } from 'obug';\n\nimport {\n  DEBUG_LOG_DIR,\n  DEBUG_LOG_FILENAME,\n  wrapInstancesForFileLog,\n  wrapInstancesForScopedFileLog,\n} from './debug-log-file.js';\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions<S extends string = string> {\n  scopes?: boolean | S[];\n  mode?: DebugMode;\n  /**\n   * Write debug output to log files under `tmp/debug/` in the workspace root.\n   * - `true` or `'single'` — all output to `tmp/debug/analog.log`\n   * - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`\n   */\n  logFile?: boolean | 'single' | 'scoped';\n}\n\nexport type DebugOption<S extends string = string> =\n  | boolean\n  | S[]\n  | DebugModeOptions<S>\n  | DebugModeOptions<S>[];\n\nexport interface DebugHarness<S extends string = string> {\n  applyDebugOption(\n    debug: DebugOption<S> | undefined,\n    workspaceRoot?: string,\n  ): void;\n  activateDeferredDebug(command: 'build' | 'serve'): void;\n  /** @internal test-only reset */\n  _resetDeferredDebug(): void;\n}\n\nfunction resolveNamespaces(\n  scopes: boolean | string[] | undefined,\n  fallback: string,\n): string | null {\n  if (scopes === true || scopes === undefined) return fallback;\n  if (Array.isArray(scopes) && scopes.length) return scopes.join(',');\n  return null;\n}\n\nfunction extractLogFile(\n  debug: DebugOption,\n): true | 'single' | 'scoped' | false {\n  if (typeof debug === 'boolean') return false;\n  if (Array.isArray(debug)) {\n    if (debug.length === 0 || typeof debug[0] === 'string') return false;\n    const entry = (debug as DebugModeOptions[]).find((e) => !!e.logFile);\n    return entry?.logFile ?? false;\n  }\n  return (debug as DebugModeOptions).logFile ?? false;\n}\n\nexport function createDebugHarness<S extends string = string>(config: {\n  fallbackNamespace: string;\n  instanceGroups: Debugger[][];\n}): DebugHarness<S> {\n  interface PendingEntry {\n    entry: DebugModeOptions<S>;\n    logFile: true | 'single' | 'scoped' | false;\n    root: string;\n  }\n\n  let pendingDebug: PendingEntry[] = [];\n\n  function installFileWrappers(\n    logFile: true | 'single' | 'scoped',\n    root: string,\n  ): void {\n    if (logFile === 'scoped') {\n      const dirPath = join(root, DEBUG_LOG_DIR);\n      for (const group of config.instanceGroups) {\n        wrapInstancesForScopedFileLog(group, dirPath);\n      }\n    } else {\n      const filePath = join(root, DEBUG_LOG_DIR, DEBUG_LOG_FILENAME);\n      for (const group of config.instanceGroups) {\n        wrapInstancesForFileLog(group, filePath);\n      }\n    }\n  }\n\n  function applyEntry(\n    entry: DebugModeOptions<S>,\n    fallback: string,\n    logFile: true | 'single' | 'scoped' | false,\n    root: string,\n  ): void {\n    if (!entry.mode) {\n      const ns = resolveNamespaces(entry.scopes ?? true, fallback);\n      if (ns) enable(ns);\n      if (logFile) installFileWrappers(logFile, root);\n    } else {\n      pendingDebug.push({ entry, logFile, root });\n    }\n  }\n\n  return {\n    applyDebugOption(\n      debug: DebugOption<S> | undefined,\n      workspaceRoot?: string,\n    ): void {\n      if (debug == null || debug === false) return;\n\n      const logFile = extractLogFile(debug);\n      const root =\n        workspaceRoot ?? process.env['NX_WORKSPACE_ROOT'] ?? process.cwd();\n\n      if (typeof debug === 'boolean') {\n        const ns = resolveNamespaces(debug, config.fallbackNamespace);\n        if (ns) enable(ns);\n        return;\n      }\n\n      if (Array.isArray(debug)) {\n        if (debug.length === 0) return;\n\n        if (typeof debug[0] === 'string') {\n          const ns = (debug as string[]).join(',');\n          if (ns) enable(ns);\n          return;\n        }\n\n        for (const entry of debug as DebugModeOptions<S>[]) {\n          const entryLogFile = entry.logFile ?? false;\n          applyEntry(\n            entry,\n            config.fallbackNamespace,\n            entryLogFile || logFile,\n            root,\n          );\n        }\n        return;\n      }\n\n      applyEntry(debug, config.fallbackNamespace, logFile, root);\n    },\n\n    activateDeferredDebug(command: 'build' | 'serve'): void {\n      if (pendingDebug.length === 0) return;\n\n      const currentMode = command === 'serve' ? 'dev' : 'build';\n\n      for (const { entry, logFile, root } of pendingDebug) {\n        if (entry.mode === currentMode) {\n          const ns = resolveNamespaces(\n            entry.scopes ?? true,\n            config.fallbackNamespace,\n          );\n          if (ns) enable(ns);\n          if (logFile) installFileWrappers(logFile, root);\n        }\n      }\n\n      pendingDebug = [];\n    },\n\n    _resetDeferredDebug(): void {\n      pendingDebug = [];\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA6CA,SAAS,kBACP,QACA,UACe;AACf,KAAI,WAAW,QAAQ,WAAW,KAAA,EAAW,QAAO;AACpD,KAAI,MAAM,QAAQ,OAAO,IAAI,OAAO,OAAQ,QAAO,OAAO,KAAK,IAAI;AACnE,QAAO;;AAGT,SAAS,eACP,OACoC;AACpC,KAAI,OAAO,UAAU,UAAW,QAAO;AACvC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,KAAK,OAAO,MAAM,OAAO,SAAU,QAAO;AAE/D,SADe,MAA6B,MAAM,MAAM,CAAC,CAAC,EAAE,QAAQ,EACtD,WAAW;;AAE3B,QAAQ,MAA2B,WAAW;;AAGhD,SAAgB,mBAA8C,QAG1C;CAOlB,IAAI,eAA+B,EAAE;CAErC,SAAS,oBACP,SACA,MACM;AACN,MAAI,YAAY,UAAU;GACxB,MAAM,UAAU,KAAK,MAAM,cAAc;AACzC,QAAK,MAAM,SAAS,OAAO,eACzB,+BAA8B,OAAO,QAAQ;SAE1C;GACL,MAAM,WAAW,KAAK,MAAM,eAAe,mBAAmB;AAC9D,QAAK,MAAM,SAAS,OAAO,eACzB,yBAAwB,OAAO,SAAS;;;CAK9C,SAAS,WACP,OACA,UACA,SACA,MACM;AACN,MAAI,CAAC,MAAM,MAAM;GACf,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,SAAS;AAC5D,OAAI,GAAI,QAAO,GAAG;AAClB,OAAI,QAAS,qBAAoB,SAAS,KAAK;QAE/C,cAAa,KAAK;GAAE;GAAO;GAAS;GAAM,CAAC;;AAI/C,QAAO;EACL,iBACE,OACA,eACM;AACN,OAAI,SAAS,QAAQ,UAAU,MAAO;GAEtC,MAAM,UAAU,eAAe,MAAM;GACrC,MAAM,OACJ,iBAAiB,QAAQ,IAAI,wBAAwB,QAAQ,KAAK;AAEpE,OAAI,OAAO,UAAU,WAAW;IAC9B,MAAM,KAAK,kBAAkB,OAAO,OAAO,kBAAkB;AAC7D,QAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,OAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAI,MAAM,WAAW,EAAG;AAExB,QAAI,OAAO,MAAM,OAAO,UAAU;KAChC,MAAM,KAAM,MAAmB,KAAK,IAAI;AACxC,SAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,SAAK,MAAM,SAAS,OAAgC;KAClD,MAAM,eAAe,MAAM,WAAW;AACtC,gBACE,OACA,OAAO,mBACP,gBAAgB,SAChB,KACD;;AAEH;;AAGF,cAAW,OAAO,OAAO,mBAAmB,SAAS,KAAK;;EAG5D,sBAAsB,SAAkC;AACtD,OAAI,aAAa,WAAW,EAAG;GAE/B,MAAM,cAAc,YAAY,UAAU,QAAQ;AAElD,QAAK,MAAM,EAAE,OAAO,SAAS,UAAU,aACrC,KAAI,MAAM,SAAS,aAAa;IAC9B,MAAM,KAAK,kBACT,MAAM,UAAU,MAChB,OAAO,kBACR;AACD,QAAI,GAAI,QAAO,GAAG;AAClB,QAAI,QAAS,qBAAoB,SAAS,KAAK;;AAInD,kBAAe,EAAE;;EAGnB,sBAA4B;AAC1B,kBAAe,EAAE;;EAEpB"}

package/src/lib/utils/debug-log-file.d.ts

@@ -0,0 +1,5 @@
+import type { Debugger } from "obug";
+export declare const DEBUG_LOG_DIR = "tmp/debug";
+export declare const DEBUG_LOG_FILENAME = "analog.log";
+export declare function wrapInstancesForFileLog(instances: Debugger[], filePath: string): void;
+export declare function wrapInstancesForScopedFileLog(instances: Debugger[], dirPath: string): void;

package/src/lib/utils/debug-log-file.js

@@ -0,0 +1,56 @@
+import { appendFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { format } from "node:util";
+//#region packages/vite-plugin-angular/src/lib/utils/debug-log-file.ts
+/**
+* Duplicates of this file (keep in sync):
+*   packages/platform/src/lib/utils/debug-log-file.ts
+*   packages/vite-plugin-angular/src/lib/utils/debug-log-file.ts
+*/
+var TRUNCATED_KEY = "__analogDebugLogTruncated";
+var WRAPPED_KEY = "__analogFileLogWrapped";
+var ANSI_RE = /\x1B\[[0-9;]*[A-Za-z]|\x1B\].*?\x07/g;
+var DEBUG_LOG_DIR = "tmp/debug";
+var DEBUG_LOG_FILENAME = "analog.log";
+function ensureTruncated(filePath) {
+	const g = globalThis;
+	const truncated = g[TRUNCATED_KEY] ?? /* @__PURE__ */ new Set();
+	g[TRUNCATED_KEY] = truncated;
+	if (truncated.has(filePath)) return;
+	try {
+		mkdirSync(dirname(filePath), { recursive: true });
+		writeFileSync(filePath, "", "utf-8");
+	} catch {}
+	truncated.add(filePath);
+}
+function wrapLog(dbg, filePath) {
+	const rec = dbg;
+	if (rec[WRAPPED_KEY] === filePath) return;
+	const originalLog = rec[WRAPPED_KEY] && rec["__analogOriginalLog"] ? rec["__analogOriginalLog"] : dbg.log;
+	rec["__analogOriginalLog"] = originalLog;
+	dbg.log = function(...args) {
+		originalLog.apply(this, args);
+		try {
+			appendFileSync(filePath, format(...args).replace(ANSI_RE, "") + "\n", "utf-8");
+		} catch {}
+	};
+	rec[WRAPPED_KEY] = filePath;
+}
+function wrapInstancesForFileLog(instances, filePath) {
+	ensureTruncated(filePath);
+	for (const dbg of instances) wrapLog(dbg, filePath);
+}
+function scopeToFilename(namespace) {
+	return namespace.replace(/:/g, ".") + ".log";
+}
+function wrapInstancesForScopedFileLog(instances, dirPath) {
+	for (const dbg of instances) {
+		const scopedPath = join(dirPath, scopeToFilename(dbg.namespace));
+		ensureTruncated(scopedPath);
+		wrapLog(dbg, scopedPath);
+	}
+}
+//#endregion
+export { DEBUG_LOG_DIR, DEBUG_LOG_FILENAME, wrapInstancesForFileLog, wrapInstancesForScopedFileLog };
+
+//# sourceMappingURL=debug-log-file.js.map

package/src/lib/utils/debug-log-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log-file.js","names":[],"sources":["../../../../src/lib/utils/debug-log-file.ts"],"sourcesContent":["/**\n * Duplicates of this file (keep in sync):\n *   packages/platform/src/lib/utils/debug-log-file.ts\n *   packages/vite-plugin-angular/src/lib/utils/debug-log-file.ts\n */\nimport { mkdirSync, writeFileSync, appendFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { format } from 'node:util';\nimport type { Debugger } from 'obug';\n\nconst TRUNCATED_KEY = '__analogDebugLogTruncated';\nconst WRAPPED_KEY = '__analogFileLogWrapped';\n// eslint-disable-next-line no-control-regex\nconst ANSI_RE = /\\x1B\\[[0-9;]*[A-Za-z]|\\x1B\\].*?\\x07/g;\n\nexport const DEBUG_LOG_DIR = 'tmp/debug';\nexport const DEBUG_LOG_FILENAME = 'analog.log';\n\nfunction ensureTruncated(filePath: string): void {\n  const g = globalThis as Record<string, unknown>;\n  const truncated = (g[TRUNCATED_KEY] as Set<string>) ?? new Set<string>();\n  g[TRUNCATED_KEY] = truncated;\n  if (truncated.has(filePath)) return;\n  try {\n    mkdirSync(dirname(filePath), { recursive: true });\n    writeFileSync(filePath, '', 'utf-8');\n  } catch {\n    // best-effort: fall through to append mode if truncation fails\n  }\n  truncated.add(filePath);\n}\n\nfunction wrapLog(dbg: Debugger, filePath: string): void {\n  const rec = dbg as Record<string, unknown>;\n  if (rec[WRAPPED_KEY] === filePath) return;\n\n  const originalLog =\n    rec[WRAPPED_KEY] && rec['__analogOriginalLog']\n      ? (rec['__analogOriginalLog'] as Debugger['log'])\n      : dbg.log;\n\n  rec['__analogOriginalLog'] = originalLog;\n  dbg.log = function (this: Debugger, ...args: unknown[]) {\n    originalLog.apply(this, args);\n    try {\n      const line = format(...args).replace(ANSI_RE, '') + '\\n';\n      appendFileSync(filePath, line, 'utf-8');\n    } catch {\n      // debug logging must never crash the build\n    }\n  };\n  rec[WRAPPED_KEY] = filePath;\n}\n\nexport function wrapInstancesForFileLog(\n  instances: Debugger[],\n  filePath: string,\n): void {\n  ensureTruncated(filePath);\n  for (const dbg of instances) {\n    wrapLog(dbg, filePath);\n  }\n}\n\nfunction scopeToFilename(namespace: string): string {\n  return namespace.replace(/:/g, '.') + '.log';\n}\n\nexport function wrapInstancesForScopedFileLog(\n  instances: Debugger[],\n  dirPath: string,\n): void {\n  for (const dbg of instances) {\n    const scopedPath = join(dirPath, scopeToFilename(dbg.namespace));\n    ensureTruncated(scopedPath);\n    wrapLog(dbg, scopedPath);\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAM,gBAAgB;AACtB,IAAM,cAAc;AAEpB,IAAM,UAAU;AAEhB,IAAa,gBAAgB;AAC7B,IAAa,qBAAqB;AAElC,SAAS,gBAAgB,UAAwB;CAC/C,MAAM,IAAI;CACV,MAAM,YAAa,EAAE,kCAAkC,IAAI,KAAa;AACxE,GAAE,iBAAiB;AACnB,KAAI,UAAU,IAAI,SAAS,CAAE;AAC7B,KAAI;AACF,YAAU,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,gBAAc,UAAU,IAAI,QAAQ;SAC9B;AAGR,WAAU,IAAI,SAAS;;AAGzB,SAAS,QAAQ,KAAe,UAAwB;CACtD,MAAM,MAAM;AACZ,KAAI,IAAI,iBAAiB,SAAU;CAEnC,MAAM,cACJ,IAAI,gBAAgB,IAAI,yBACnB,IAAI,yBACL,IAAI;AAEV,KAAI,yBAAyB;AAC7B,KAAI,MAAM,SAA0B,GAAG,MAAiB;AACtD,cAAY,MAAM,MAAM,KAAK;AAC7B,MAAI;AAEF,kBAAe,UADF,OAAO,GAAG,KAAK,CAAC,QAAQ,SAAS,GAAG,GAAG,MACrB,QAAQ;UACjC;;AAIV,KAAI,eAAe;;AAGrB,SAAgB,wBACd,WACA,UACM;AACN,iBAAgB,SAAS;AACzB,MAAK,MAAM,OAAO,UAChB,SAAQ,KAAK,SAAS;;AAI1B,SAAS,gBAAgB,WAA2B;AAClD,QAAO,UAAU,QAAQ,MAAM,IAAI,GAAG;;AAGxC,SAAgB,8BACd,WACA,SACM;AACN,MAAK,MAAM,OAAO,WAAW;EAC3B,MAAM,aAAa,KAAK,SAAS,gBAAgB,IAAI,UAAU,CAAC;AAChE,kBAAgB,WAAW;AAC3B,UAAQ,KAAK,WAAW"}

package/src/lib/utils/debug.d.ts

@@ -0,0 +1,26 @@
+export declare const debugHmr: unknown;
+export declare const debugStyles: unknown;
+export declare const debugCompiler: unknown;
+export declare const debugCompilationApi: unknown;
+export declare const debugEmit: unknown;
+export declare const debugStylePipeline: unknown;
+export declare const debugHmrV: unknown;
+export declare const debugStylesV: unknown;
+export declare const debugCompilerV: unknown;
+export declare const debugEmitV: unknown;
+export type DebugScope = "analog:angular:*" | "analog:angular:hmr" | "analog:angular:hmr:v" | "analog:angular:styles" | "analog:angular:styles:v" | "analog:angular:compiler" | "analog:angular:compiler:v" | "analog:angular:compilation-api" | "analog:angular:emit" | "analog:angular:emit:v" | "analog:angular:style-pipeline" | (string & {});
+export type DebugMode = "build" | "dev";
+export interface DebugModeOptions {
+	scopes?: boolean | DebugScope[];
+	mode?: DebugMode;
+	/**
+	* Write debug output to log files under `tmp/debug/` in the workspace root.
+	* - `true` or `'single'` — all output to `tmp/debug/analog.log`
+	* - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`
+	*/
+	logFile?: boolean | "single" | "scoped";
+}
+export type DebugOption = boolean | DebugScope[] | DebugModeOptions | DebugModeOptions[];
+export declare const applyDebugOption: (debug: DebugOption | undefined, workspaceRoot?: string) => void;
+export declare const activateDeferredDebug: (command: "build" | "serve") => void;
+export declare const _resetDeferredDebug: () => void;

package/src/lib/utils/debug.js

@@ -0,0 +1,35 @@
+import { createDebugHarness } from "./debug-harness.js";
+import { createDebug } from "obug";
+//#region packages/vite-plugin-angular/src/lib/utils/debug.ts
+var debugHmr = createDebug("analog:angular:hmr");
+var debugStyles = createDebug("analog:angular:styles");
+var debugCompiler = createDebug("analog:angular:compiler");
+var debugCompilationApi = createDebug("analog:angular:compilation-api");
+var debugEmit = createDebug("analog:angular:emit");
+var debugStylePipeline = createDebug("analog:angular:style-pipeline");
+var debugHmrV = createDebug("analog:angular:hmr:v");
+var debugStylesV = createDebug("analog:angular:styles:v");
+var debugCompilerV = createDebug("analog:angular:compiler:v");
+var debugEmitV = createDebug("analog:angular:emit:v");
+var harness = createDebugHarness({
+	fallbackNamespace: "analog:angular:*",
+	instanceGroups: [[
+		debugHmr,
+		debugStyles,
+		debugCompiler,
+		debugCompilationApi,
+		debugEmit,
+		debugStylePipeline,
+		debugHmrV,
+		debugStylesV,
+		debugCompilerV,
+		debugEmitV
+	]]
+});
+var applyDebugOption = harness.applyDebugOption;
+var activateDeferredDebug = harness.activateDeferredDebug;
+harness._resetDeferredDebug;
+//#endregion
+export { activateDeferredDebug, applyDebugOption, debugCompilationApi, debugCompiler, debugCompilerV, debugEmit, debugEmitV, debugHmr, debugHmrV, debugStylePipeline, debugStyles, debugStylesV };
+
+//# sourceMappingURL=debug.js.map

package/src/lib/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug } from 'obug';\nimport { createDebugHarness } from './debug-harness.js';\n\n// Normal — key decisions, once per startup or per component\nexport const debugHmr = createDebug('analog:angular:hmr');\nexport const debugStyles = createDebug('analog:angular:styles');\nexport const debugCompiler = createDebug('analog:angular:compiler');\nexport const debugCompilationApi = createDebug(\n  'analog:angular:compilation-api',\n);\nexport const debugEmit = createDebug('analog:angular:emit');\nexport const debugStylePipeline = createDebug('analog:angular:style-pipeline');\n\n// Verbose — per-file detail, enable with :v suffix or parent:*\nexport const debugHmrV = createDebug('analog:angular:hmr:v');\nexport const debugStylesV = createDebug('analog:angular:styles:v');\nexport const debugCompilerV = createDebug('analog:angular:compiler:v');\nexport const debugEmitV = createDebug('analog:angular:emit:v');\n\nconst angularDebugInstances = [\n  debugHmr,\n  debugStyles,\n  debugCompiler,\n  debugCompilationApi,\n  debugEmit,\n  debugStylePipeline,\n  debugHmrV,\n  debugStylesV,\n  debugCompilerV,\n  debugEmitV,\n];\n\nexport type DebugScope =\n  | 'analog:angular:*'\n  | 'analog:angular:hmr'\n  | 'analog:angular:hmr:v'\n  | 'analog:angular:styles'\n  | 'analog:angular:styles:v'\n  | 'analog:angular:compiler'\n  | 'analog:angular:compiler:v'\n  | 'analog:angular:compilation-api'\n  | 'analog:angular:emit'\n  | 'analog:angular:emit:v'\n  | 'analog:angular:style-pipeline'\n  | (string & {});\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions {\n  scopes?: boolean | DebugScope[];\n  mode?: DebugMode;\n  /**\n   * Write debug output to log files under `tmp/debug/` in the workspace root.\n   * - `true` or `'single'` — all output to `tmp/debug/analog.log`\n   * - `'scoped'` — one file per scope, e.g. `tmp/debug/analog.angular.hmr.log`\n   */\n  logFile?: boolean | 'single' | 'scoped';\n}\n\nexport type DebugOption =\n  | boolean\n  | DebugScope[]\n  | DebugModeOptions\n  | DebugModeOptions[];\n\nconst harness = createDebugHarness({\n  fallbackNamespace: 'analog:angular:*',\n  instanceGroups: [angularDebugInstances],\n});\n\nexport const applyDebugOption: (\n  debug: DebugOption | undefined,\n  workspaceRoot?: string,\n) => void = harness.applyDebugOption;\nexport const activateDeferredDebug: (command: 'build' | 'serve') => void =\n  harness.activateDeferredDebug;\nexport const _resetDeferredDebug: () => void = harness._resetDeferredDebug;\n"],"mappings":";;;AAIA,IAAa,WAAW,YAAY,qBAAqB;AACzD,IAAa,cAAc,YAAY,wBAAwB;AAC/D,IAAa,gBAAgB,YAAY,0BAA0B;AACnE,IAAa,sBAAsB,YACjC,iCACD;AACD,IAAa,YAAY,YAAY,sBAAsB;AAC3D,IAAa,qBAAqB,YAAY,gCAAgC;AAG9E,IAAa,YAAY,YAAY,uBAAuB;AAC5D,IAAa,eAAe,YAAY,0BAA0B;AAClE,IAAa,iBAAiB,YAAY,4BAA4B;AACtE,IAAa,aAAa,YAAY,wBAAwB;AAgD9D,IAAM,UAAU,mBAAmB;CACjC,mBAAmB;CACnB,gBAAgB,CAhDY;EAC5B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAqCwC;CACxC,CAAC;AAEF,IAAa,mBAGD,QAAQ;AACpB,IAAa,wBACX,QAAQ;AACqC,QAAQ"}

package/src/lib/utils/devkit.d.ts

@@ -1,10 +1,18 @@
-import type { CompilerPluginOptions } from './compiler-plugin-options.js';
-declare const angularMajor: number;
-declare const angularMinor: number;
-declare const angularPatch: number;
-declare const angularFullVersion: number;
+import type { JavaScriptTransformer as AngularJavaScriptTransformer } from "@angular/build/private";
+import type { CompilerPluginOptions } from "./compiler-plugin-options.js";
+import type { TransformCacheStore } from "./transform-cache.js";
+declare const angularMajor: unknown;
+declare const angularMinor: unknown;
+declare const angularPatch: unknown;
+declare const angularFullVersion: unknown;
 declare let sourceFileCache: any;
 declare let cjt: (...args: any[]) => any;
 declare let jt: any;
 declare let createAngularCompilation: (...args: any[]) => any;
-export { cjt as createJitResourceTransformer, jt as JavaScriptTransformer, sourceFileCache as SourceFileCache, CompilerPluginOptions, angularMajor, angularMinor, angularPatch, createAngularCompilation, angularFullVersion, };
+declare class JavaScriptTransformer extends jt {
+	constructor(options: Partial<ConstructorParameters<typeof AngularJavaScriptTransformer>[0]>, maxThreads: number, cache?: TransformCacheStore);
+	transformFile(filename: string, skipLinker?: boolean, sideEffects?: boolean, instrumentForCoverage?: boolean): Promise<Uint8Array>;
+	transformData(filename: string, data: string, skipLinker: boolean, sideEffects?: boolean, instrumentForCoverage?: boolean): Promise<Uint8Array>;
+	close(): Promise<void>;
+}
+export { cjt as createJitResourceTransformer, JavaScriptTransformer, sourceFileCache as SourceFileCache, CompilerPluginOptions, angularMajor, angularMinor, angularPatch, createAngularCompilation, angularFullVersion };

package/src/lib/utils/devkit.js

@@ -1,6 +1,7 @@
 import { SourceFileCache } from "./source-file-cache.js";
-import { VERSION } from "@angular/compiler-cli";
+import { dirname, join } from "node:path";
 import { createRequire } from "node:module";
+import { VERSION } from "@angular/compiler-cli";
 //#region packages/vite-plugin-angular/src/lib/utils/devkit.ts
 var require = createRequire(import.meta.url);
 var angularMajor = Number(VERSION.major);
@@ -12,6 +13,8 @@ var sourceFileCache;
 var cjt;
 var jt;
 var createAngularCompilation;
+var usesTransformOptions = angularFullVersion >= 220200;
+var initializeHash;
 if (angularMajor < 17) throw new Error("AnalogJS is not compatible with Angular v16 and lower");
 else if (angularMajor >= 17 && angularMajor < 18) {
 	const cp = require("@angular-devkit/build-angular/src/tools/esbuild/angular/compiler-plugin.js");
@@ -30,8 +33,43 @@ else if (angularMajor >= 17 && angularMajor < 18) {
 	cjt = createJitResourceTransformer;
 	jt = JavaScriptTransformer;
 	createAngularCompilation = createAngularCompilationFn;
+	if (usesTransformOptions) ({initializeHash} = require(join(dirname(require.resolve("@angular/build/package.json")), "src/utils/hash.js")));
 }
+var JavaScriptTransformer = class extends jt {
+	constructor(options, maxThreads, cache) {
+		if (usesTransformOptions) super({
+			...options,
+			maxConcurrency: maxThreads
+		}, cache);
+		else super(options, maxThreads, cache);
+	}
+	async transformFile(filename, skipLinker, sideEffects, instrumentForCoverage) {
+		if (usesTransformOptions) {
+			await initializeHash();
+			return super.transformFile(filename, {
+				skipLinker,
+				sideEffects: sideEffects === void 0 ? void 0 : async () => sideEffects,
+				instrumentForCoverage
+			});
+		}
+		return super.transformFile(filename, skipLinker, sideEffects, instrumentForCoverage);
+	}
+	async transformData(filename, data, skipLinker, sideEffects, instrumentForCoverage) {
+		if (usesTransformOptions) {
+			await initializeHash();
+			return super.transformData(filename, data, {
+				skipLinker,
+				sideEffects: sideEffects === void 0 ? void 0 : async () => sideEffects,
+				instrumentForCoverage
+			});
+		}
+		return super.transformData(filename, data, skipLinker, sideEffects, instrumentForCoverage);
+	}
+	close() {
+		return super.close();
+	}
+};
 //#endregion
-export { angularFullVersion, cjt, createAngularCompilation, jt, sourceFileCache };
+export { JavaScriptTransformer, angularFullVersion, cjt, createAngularCompilation, sourceFileCache };
 
 //# sourceMappingURL=devkit.js.map

package/src/lib/utils/devkit.js.map

@@ -1 +1 @@
-{"version":3,"file":"devkit.js","names":[],"sources":["../../../../../../packages/vite-plugin-angular/src/lib/utils/devkit.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { createRequire } from 'node:module';\nimport type { CompilerPluginOptions } from './compiler-plugin-options.js';\nimport * as sfc from './source-file-cache.js';\n\nconst require = createRequire(import.meta.url);\n\nconst angularMajor: number = Number(VERSION.major);\nconst angularMinor: number = Number(VERSION.minor);\nconst angularPatch: number = Number(VERSION.patch);\nconst padVersion = (version: number) => String(version).padStart(2, '0');\nconst angularFullVersion: number = Number(\n  `${angularMajor}${padVersion(angularMinor)}${padVersion(angularPatch)}`,\n);\nlet sourceFileCache: any;\nlet cjt: (...args: any[]) => any;\nlet jt: any;\nlet createAngularCompilation: (...args: any[]) => any;\n\nif (angularMajor < 17) {\n  throw new Error('AnalogJS is not compatible with Angular v16 and lower');\n} else if (angularMajor >= 17 && angularMajor < 18) {\n  const cp = require('@angular-devkit/build-angular/src/tools/esbuild/angular/compiler-plugin.js');\n  const {\n    createJitResourceTransformer,\n  } = require('@angular-devkit/build-angular/src/tools/esbuild/angular/jit-resource-transformer.js');\n  const {\n    JavaScriptTransformer,\n  } = require('@angular-devkit/build-angular/src/tools/esbuild/javascript-transformer.js');\n\n  /**\n   * Workaround for compatibility with Angular 17.0+\n   */\n  if (typeof cp['SourceFileCache'] !== 'undefined') {\n    sourceFileCache = cp.SourceFileCache;\n  } else {\n    sourceFileCache = sfc.SourceFileCache;\n  }\n\n  cjt = createJitResourceTransformer;\n  jt = JavaScriptTransformer;\n} else {\n  const {\n    createJitResourceTransformer,\n    JavaScriptTransformer,\n    SourceFileCache,\n    createAngularCompilation: createAngularCompilationFn,\n  } = require('@angular/build/private');\n\n  sourceFileCache = SourceFileCache;\n  cjt = createJitResourceTransformer;\n  jt = JavaScriptTransformer;\n  createAngularCompilation = createAngularCompilationFn;\n}\n\nexport {\n  cjt as createJitResourceTransformer,\n  jt as JavaScriptTransformer,\n  sourceFileCache as SourceFileCache,\n  CompilerPluginOptions,\n  angularMajor,\n  angularMinor,\n  angularPatch,\n  createAngularCompilation,\n  angularFullVersion,\n};\n"],"mappings":";;;;AAKA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,IAAM,eAAuB,OAAO,QAAQ,MAAM;AAClD,IAAM,eAAuB,OAAO,QAAQ,MAAM;AAClD,IAAM,eAAuB,OAAO,QAAQ,MAAM;AAClD,IAAM,cAAc,YAAoB,OAAO,QAAQ,CAAC,SAAS,GAAG,IAAI;AACxE,IAAM,qBAA6B,OACjC,GAAG,eAAe,WAAW,aAAa,GAAG,WAAW,aAAa,GACtE;AACD,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AAEJ,IAAI,eAAe,GACjB,OAAM,IAAI,MAAM,wDAAwD;SAC/D,gBAAgB,MAAM,eAAe,IAAI;CAClD,MAAM,KAAK,QAAQ,6EAA6E;CAChG,MAAM,EACJ,iCACE,QAAQ,sFAAsF;CAClG,MAAM,EACJ,0BACE,QAAQ,4EAA4E;;;;AAKxF,KAAI,OAAO,GAAG,uBAAuB,YACnC,mBAAkB,GAAG;KAErB,mBAAkB;AAGpB,OAAM;AACN,MAAK;OACA;CACL,MAAM,EACJ,8BACA,uBACA,iBACA,0BAA0B,+BACxB,QAAQ,yBAAyB;AAErC,mBAAkB;AAClB,OAAM;AACN,MAAK;AACL,4BAA2B"}
+{"version":3,"file":"devkit.js","names":[],"sources":["../../../../src/lib/utils/devkit.ts"],"sourcesContent":["import { VERSION } from '@angular/compiler-cli';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\nimport type { JavaScriptTransformer as AngularJavaScriptTransformer } from '@angular/build/private';\nimport type { CompilerPluginOptions } from './compiler-plugin-options.js';\nimport type { TransformCacheStore } from './transform-cache.js';\nimport * as sfc from './source-file-cache.js';\n\nconst require = createRequire(import.meta.url);\n\nconst angularMajor = Number(VERSION.major);\nconst angularMinor = Number(VERSION.minor);\nconst angularPatch = Number(VERSION.patch);\nconst padVersion = (version: number) => String(version).padStart(2, '0');\nconst angularFullVersion = Number(\n  `${angularMajor}${padVersion(angularMinor)}${padVersion(angularPatch)}`,\n);\nlet sourceFileCache: any;\nlet cjt: (...args: any[]) => any;\nlet jt: any;\nlet createAngularCompilation: (...args: any[]) => any;\nconst usesTransformOptions = angularFullVersion >= 220200;\nlet initializeHash: (() => Promise<void>) | undefined;\n\nif (angularMajor < 17) {\n  throw new Error('AnalogJS is not compatible with Angular v16 and lower');\n} else if (angularMajor >= 17 && angularMajor < 18) {\n  const cp = require('@angular-devkit/build-angular/src/tools/esbuild/angular/compiler-plugin.js');\n  const {\n    createJitResourceTransformer,\n  } = require('@angular-devkit/build-angular/src/tools/esbuild/angular/jit-resource-transformer.js');\n  const {\n    JavaScriptTransformer,\n  } = require('@angular-devkit/build-angular/src/tools/esbuild/javascript-transformer.js');\n\n  /**\n   * Workaround for compatibility with Angular 17.0+\n   */\n  if (typeof cp['SourceFileCache'] !== 'undefined') {\n    sourceFileCache = cp.SourceFileCache;\n  } else {\n    sourceFileCache = sfc.SourceFileCache;\n  }\n\n  cjt = createJitResourceTransformer;\n  jt = JavaScriptTransformer;\n} else {\n  const {\n    createJitResourceTransformer,\n    JavaScriptTransformer,\n    SourceFileCache,\n    createAngularCompilation: createAngularCompilationFn,\n  } = require('@angular/build/private');\n\n  sourceFileCache = SourceFileCache;\n  cjt = createJitResourceTransformer;\n  jt = JavaScriptTransformer;\n  createAngularCompilation = createAngularCompilationFn;\n\n  if (usesTransformOptions) {\n    ({ initializeHash } = require(\n      join(\n        dirname(require.resolve('@angular/build/package.json')),\n        'src/utils/hash.js',\n      ),\n    ));\n  }\n}\n\n// Keep Angular's private transformer API differences at the compatibility boundary.\nclass JavaScriptTransformer extends jt {\n  constructor(\n    options: Partial<\n      ConstructorParameters<typeof AngularJavaScriptTransformer>[0]\n    >,\n    maxThreads: number,\n    cache?: TransformCacheStore,\n  ) {\n    if (usesTransformOptions) {\n      super({ ...options, maxConcurrency: maxThreads }, cache);\n    } else {\n      super(options, maxThreads, cache);\n    }\n  }\n\n  async transformFile(\n    filename: string,\n    skipLinker?: boolean,\n    sideEffects?: boolean,\n    instrumentForCoverage?: boolean,\n  ): Promise<Uint8Array> {\n    if (usesTransformOptions) {\n      await initializeHash!();\n      return super.transformFile(filename, {\n        skipLinker,\n        sideEffects:\n          sideEffects === undefined ? undefined : async () => sideEffects,\n        instrumentForCoverage,\n      });\n    }\n    return super.transformFile(\n      filename,\n      skipLinker,\n      sideEffects,\n      instrumentForCoverage,\n    );\n  }\n\n  async transformData(\n    filename: string,\n    data: string,\n    skipLinker: boolean,\n    sideEffects?: boolean,\n    instrumentForCoverage?: boolean,\n  ): Promise<Uint8Array> {\n    if (usesTransformOptions) {\n      await initializeHash!();\n      return super.transformData(filename, data, {\n        skipLinker,\n        sideEffects:\n          sideEffects === undefined ? undefined : async () => sideEffects,\n        instrumentForCoverage,\n      });\n    }\n    return super.transformData(\n      filename,\n      data,\n      skipLinker,\n      sideEffects,\n      instrumentForCoverage,\n    );\n  }\n\n  close(): Promise<void> {\n    return super.close();\n  }\n}\n\nexport {\n  cjt as createJitResourceTransformer,\n  JavaScriptTransformer,\n  sourceFileCache as SourceFileCache,\n  CompilerPluginOptions,\n  angularMajor,\n  angularMinor,\n  angularPatch,\n  createAngularCompilation,\n  angularFullVersion,\n};\n"],"mappings":";;;;;AAQA,IAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAE9C,IAAM,eAAe,OAAO,QAAQ,MAAM;AAC1C,IAAM,eAAe,OAAO,QAAQ,MAAM;AAC1C,IAAM,eAAe,OAAO,QAAQ,MAAM;AAC1C,IAAM,cAAc,YAAoB,OAAO,QAAQ,CAAC,SAAS,GAAG,IAAI;AACxE,IAAM,qBAAqB,OACzB,GAAG,eAAe,WAAW,aAAa,GAAG,WAAW,aAAa,GACtE;AACD,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAI;AACJ,IAAM,uBAAuB,sBAAsB;AACnD,IAAI;AAEJ,IAAI,eAAe,GACjB,OAAM,IAAI,MAAM,wDAAwD;SAC/D,gBAAgB,MAAM,eAAe,IAAI;CAClD,MAAM,KAAK,QAAQ,6EAA6E;CAChG,MAAM,EACJ,iCACE,QAAQ,sFAAsF;CAClG,MAAM,EACJ,0BACE,QAAQ,4EAA4E;;;;AAKxF,KAAI,OAAO,GAAG,uBAAuB,YACnC,mBAAkB,GAAG;KAErB,mBAAkB;AAGpB,OAAM;AACN,MAAK;OACA;CACL,MAAM,EACJ,8BACA,uBACA,iBACA,0BAA0B,+BACxB,QAAQ,yBAAyB;AAErC,mBAAkB;AAClB,OAAM;AACN,MAAK;AACL,4BAA2B;AAE3B,KAAI,qBACF,EAAC,CAAE,kBAAmB,QACpB,KACE,QAAQ,QAAQ,QAAQ,8BAA8B,CAAC,EACvD,oBACD,CACF;;AAKL,IAAM,wBAAN,cAAoC,GAAG;CACrC,YACE,SAGA,YACA,OACA;AACA,MAAI,qBACF,OAAM;GAAE,GAAG;GAAS,gBAAgB;GAAY,EAAE,MAAM;MAExD,OAAM,SAAS,YAAY,MAAM;;CAIrC,MAAM,cACJ,UACA,YACA,aACA,uBACqB;AACrB,MAAI,sBAAsB;AACxB,SAAM,gBAAiB;AACvB,UAAO,MAAM,cAAc,UAAU;IACnC;IACA,aACE,gBAAgB,KAAA,IAAY,KAAA,IAAY,YAAY;IACtD;IACD,CAAC;;AAEJ,SAAO,MAAM,cACX,UACA,YACA,aACA,sBACD;;CAGH,MAAM,cACJ,UACA,MACA,YACA,aACA,uBACqB;AACrB,MAAI,sBAAsB;AACxB,SAAM,gBAAiB;AACvB,UAAO,MAAM,cAAc,UAAU,MAAM;IACzC;IACA,aACE,gBAAgB,KAAA,IAAY,KAAA,IAAY,YAAY;IACtD;IACD,CAAC;;AAEJ,SAAO,MAAM,cACX,UACA,MACA,YACA,aACA,sBACD;;CAGH,QAAuB;AACrB,SAAO,MAAM,OAAO"}

package/src/lib/utils/hmr-candidates.d.ts

@@ -1,32 +1,32 @@
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
- */
-import { NgtscProgram } from '@angular/compiler-cli';
-import ts from 'typescript';
+* @license
+* Copyright Google LLC All Rights Reserved.
+*
+* Use of this source code is governed by an MIT-style license that can be
+* found in the LICENSE file at https://angular.dev/license
+*/
+import { NgtscProgram } from "@angular/compiler-cli";
+import ts from "typescript";
 /**
- * Analyzes one or more modified files for changes to determine if any
- * class declarations for Angular components are candidates for hot
- * module replacement (HMR). If any source files are also modified but
- * are not candidates then all candidates become invalid. This invalidation
- * ensures that a full rebuild occurs and the running application stays
- * synchronized with the code.
- * @param modifiedFiles A set of modified files to analyze.
- * @param param1 An Angular compiler instance
- * @param staleSourceFiles A map of paths to previous source file instances.
- * @returns A set of HMR candidate component class declarations.
- */
+* Analyzes one or more modified files for changes to determine if any
+* class declarations for Angular components are candidates for hot
+* module replacement (HMR). If any source files are also modified but
+* are not candidates then all candidates become invalid. This invalidation
+* ensures that a full rebuild occurs and the running application stays
+* synchronized with the code.
+* @param modifiedFiles A set of modified files to analyze.
+* @param param1 An Angular compiler instance
+* @param staleSourceFiles A map of paths to previous source file instances.
+* @returns A set of HMR candidate component class declarations.
+*/
 export declare function collectHmrCandidates(modifiedFiles: Set<string>, { compiler }: NgtscProgram, staleSourceFiles: Map<string, ts.SourceFile> | undefined): Set<ts.ClassDeclaration>;
 /**
- * Analyzes the updates of a source file for potential HMR component class candidates.
- * A source file can contain candidates if only the Angular component metadata of a class
- * has been changed and the metadata changes are only of supported fields.
- * @param stale The stale (previous) source file instance.
- * @param updated The updated source file instance.
- * @param compiler An Angular compiler instance.
- * @returns An array of candidate class declarations; or `null` if unsupported changes are present.
- */
-export declare function analyzeFileUpdates(stale: ts.SourceFile, updated: ts.SourceFile, compiler: NgtscProgram['compiler']): ts.ClassDeclaration[] | null;
+* Analyzes the updates of a source file for potential HMR component class candidates.
+* A source file can contain candidates if only the Angular component metadata of a class
+* has been changed and the metadata changes are only of supported fields.
+* @param stale The stale (previous) source file instance.
+* @param updated The updated source file instance.
+* @param compiler An Angular compiler instance.
+* @returns An array of candidate class declarations; or `null` if unsupported changes are present.
+*/
+export declare function analyzeFileUpdates(stale: ts.SourceFile, updated: ts.SourceFile, compiler: NgtscProgram["compiler"]): ts.ClassDeclaration[] | null;

package/src/lib/utils/jit-inline-styles.d.ts

@@ -0,0 +1,3 @@
+export declare const JIT_INLINE_STYLE_PREFIX = "virtual:angular:jit:style:inline;";
+export declare function toJitInlineStyleId(encodedStyles: string): string;
+export declare function getJitInlineStyles(hash: string): string | undefined;

package/src/lib/utils/jit-inline-styles.js

@@ -0,0 +1,16 @@
+import { createHash } from "node:crypto";
+//#region packages/vite-plugin-angular/src/lib/utils/jit-inline-styles.ts
+var JIT_INLINE_STYLE_PREFIX = "virtual:angular:jit:style:inline;";
+var inlineStyles = /* @__PURE__ */ new Map();
+function toJitInlineStyleId(encodedStyles) {
+	const hash = createHash("sha256").update(encodedStyles).digest("hex").slice(0, 16);
+	inlineStyles.set(hash, encodedStyles);
+	return `${JIT_INLINE_STYLE_PREFIX}${hash}`;
+}
+function getJitInlineStyles(hash) {
+	return inlineStyles.get(hash);
+}
+//#endregion
+export { JIT_INLINE_STYLE_PREFIX, getJitInlineStyles, toJitInlineStyleId };
+
+//# sourceMappingURL=jit-inline-styles.js.map

package/src/lib/utils/jit-inline-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jit-inline-styles.js","names":[],"sources":["../../../../src/lib/utils/jit-inline-styles.ts"],"sourcesContent":["// Angular's JIT resource transformer emits inline component styles as\n// `angular:jit:style:inline;<base64 of the whole stylesheet>`. Keeping that\n// payload in the module id makes the emitted chunk name grow with the\n// stylesheet, so a large inline style blows past the 255-byte filename\n// limit and the build fails with ENAMETOOLONG. Hash the payload into the\n// id and keep the base64 in a lookup table instead. (#2459)\n\nimport { createHash } from 'node:crypto';\n\nexport const JIT_INLINE_STYLE_PREFIX = 'virtual:angular:jit:style:inline;';\n\nconst inlineStyles = new Map<string, string>();\n\nexport function toJitInlineStyleId(encodedStyles: string): string {\n  const hash = createHash('sha256')\n    .update(encodedStyles)\n    .digest('hex')\n    .slice(0, 16);\n  inlineStyles.set(hash, encodedStyles);\n  return `${JIT_INLINE_STYLE_PREFIX}${hash}`;\n}\n\nexport function getJitInlineStyles(hash: string): string | undefined {\n  return inlineStyles.get(hash);\n}\n"],"mappings":";;AASA,IAAa,0BAA0B;AAEvC,IAAM,+BAAe,IAAI,KAAqB;AAE9C,SAAgB,mBAAmB,eAA+B;CAChE,MAAM,OAAO,WAAW,SAAS,CAC9B,OAAO,cAAc,CACrB,OAAO,MAAM,CACb,MAAM,GAAG,GAAG;AACf,cAAa,IAAI,MAAM,cAAc;AACrC,QAAO,GAAG,0BAA0B;;AAGtC,SAAgB,mBAAmB,MAAkC;AACnE,QAAO,aAAa,IAAI,KAAK"}

package/src/lib/utils/plugin-config.d.ts

@@ -0,0 +1,41 @@
+/**
+* TypeScript file extension regex
+* Match .ts / .cts / .mts extensions with an optional ?query suffix.
+* Reject .tsx — and any other `.ts<letter>…` extension like .tsrx — via
+* a negative-lookahead on a following ASCII letter, so only genuine TS
+* files pass.
+*
+* Previous form `/\.[cm]?(ts)[^x]?\??/` was intended to exclude `.tsx`
+* specifically (`[^x]?` = not-an-x), but the `?` quantifier also allows
+* zero characters, and any non-`x` letter was admitted — so `.tsrx`
+* and similar extensions matched by accident.
+*/
+export declare const TS_EXT_REGEX: unknown;
+/**
+* Resolves whether Angular should be compiled for production. An explicit
+* `development` mode wins over an ambient production `NODE_ENV` (e.g. set by
+* `storybook build` at CLI entry), so a build can opt into Angular's
+* development compilation. See #2458 and #2462.
+*/
+export declare function isProdMode(mode: string | undefined): boolean;
+export interface TsConfigResolutionContext {
+	root: string;
+	isProd: boolean;
+	isLib: boolean;
+}
+export declare function getTsConfigPath(root: string, tsconfig: string, isProd: boolean, isTest: boolean, isLib: boolean, workspaceRoot?: string);
+export declare function createTsConfigGetter(tsconfigOrGetter?: string | (() => string));
+export interface DepOptimizerOptions {
+	tsconfig: string;
+	isProd: boolean;
+	jit: boolean;
+	watchMode: boolean;
+	isTest: boolean;
+	isAstroIntegration: boolean;
+}
+export declare function createDepOptimizerConfig(opts: DepOptimizerOptions): {
+	optimizeDeps: {
+		include: unknown;
+		exclude: unknown;
+	};
+};

package/src/lib/utils/plugin-config.js

@@ -0,0 +1,85 @@
+import { createCompilerPlugin, createRolldownCompilerPlugin } from "../compiler-plugin.js";
+import { createPersistentTransformCache, resolveTransformCacheDir } from "./transform-cache.js";
+import { existsSync } from "node:fs";
+import { dirname, isAbsolute, resolve } from "node:path";
+import * as vite from "vite";
+//#region packages/vite-plugin-angular/src/lib/utils/plugin-config.ts
+/**
+* TypeScript file extension regex
+* Match .ts / .cts / .mts extensions with an optional ?query suffix.
+* Reject .tsx — and any other `.ts<letter>…` extension like .tsrx — via
+* a negative-lookahead on a following ASCII letter, so only genuine TS
+* files pass.
+*
+* Previous form `/\.[cm]?(ts)[^x]?\??/` was intended to exclude `.tsx`
+* specifically (`[^x]?` = not-an-x), but the `?` quantifier also allows
+* zero characters, and any non-`x` letter was admitted — so `.tsrx`
+* and similar extensions matched by accident.
+*/
+var TS_EXT_REGEX = /\.[cm]?ts(?![a-z])/;
+/**
+* Resolves whether Angular should be compiled for production. An explicit
+* `development` mode wins over an ambient production `NODE_ENV` (e.g. set by
+* `storybook build` at CLI entry), so a build can opt into Angular's
+* development compilation. See #2458 and #2462.
+*/
+function isProdMode(mode) {
+	if (mode === "development") return false;
+	return mode === "production" || process.env.NODE_ENV === "production";
+}
+function getTsConfigPath(root, tsconfig, isProd, isTest, isLib, workspaceRoot) {
+	if (tsconfig && isAbsolute(tsconfig)) {
+		if (!existsSync(tsconfig)) console.error(`[@analogjs/vite-plugin-angular]: Unable to resolve tsconfig at ${tsconfig}. This causes compilation issues. Check the path or set the "tsconfig" property with an absolute path.`);
+		return tsconfig;
+	}
+	let tsconfigFilePath = "./tsconfig.app.json";
+	if (isLib) tsconfigFilePath = isProd ? "./tsconfig.lib.prod.json" : "./tsconfig.lib.json";
+	if (isTest) tsconfigFilePath = "./tsconfig.spec.json";
+	if (tsconfig) tsconfigFilePath = tsconfig;
+	const resolvedPath = resolve(root, tsconfigFilePath);
+	if (existsSync(resolvedPath)) return resolvedPath;
+	const workspacePath = workspaceRoot ? resolve(workspaceRoot, tsconfigFilePath) : void 0;
+	if (workspacePath && existsSync(workspacePath)) return workspacePath;
+	const attemptedPaths = workspacePath && workspacePath !== resolvedPath ? `${resolvedPath} or ${workspacePath}` : resolvedPath;
+	console.error(`[@analogjs/vite-plugin-angular]: Unable to resolve tsconfig at ${attemptedPaths}. This causes compilation issues. Check the path or set the "tsconfig" property with an absolute path.`);
+	return resolvedPath;
+}
+function createTsConfigGetter(tsconfigOrGetter) {
+	if (typeof tsconfigOrGetter === "function") return tsconfigOrGetter;
+	return () => tsconfigOrGetter || "";
+}
+function createDepOptimizerConfig(opts) {
+	const defineOptions = {
+		ngJitMode: "false",
+		ngI18nClosureMode: "false",
+		...opts.watchMode ? {} : { ngDevMode: "false" }
+	};
+	const transformCacheDir = resolveTransformCacheDir(dirname(opts.tsconfig));
+	const transformCache = transformCacheDir ? createPersistentTransformCache(transformCacheDir) : void 0;
+	const rolldownOptions = { plugins: [createRolldownCompilerPlugin({
+		tsconfig: opts.tsconfig,
+		sourcemap: !opts.isProd,
+		advancedOptimizations: opts.isProd,
+		jit: opts.jit,
+		incremental: opts.watchMode
+	}, opts.isTest, !opts.isAstroIntegration, transformCache)] };
+	const esbuildOptions = {
+		plugins: [createCompilerPlugin({
+			tsconfig: opts.tsconfig,
+			sourcemap: !opts.isProd,
+			advancedOptimizations: opts.isProd,
+			jit: opts.jit,
+			incremental: opts.watchMode
+		}, opts.isTest, !opts.isAstroIntegration, transformCache)],
+		define: defineOptions
+	};
+	return { optimizeDeps: {
+		include: ["rxjs/operators", "rxjs"],
+		exclude: ["@angular/platform-server"],
+		...vite.rolldownVersion ? { rolldownOptions } : { esbuildOptions }
+	} };
+}
+//#endregion
+export { TS_EXT_REGEX, createDepOptimizerConfig, createTsConfigGetter, getTsConfigPath, isProdMode };
+
+//# sourceMappingURL=plugin-config.js.map

package/src/lib/utils/plugin-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.js","names":[],"sources":["../../../../src/lib/utils/plugin-config.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport * as vite from 'vite';\n\nimport {\n  createCompilerPlugin,\n  createRolldownCompilerPlugin,\n} from '../compiler-plugin.js';\nimport {\n  createPersistentTransformCache,\n  resolveTransformCacheDir,\n} from './transform-cache.js';\n\n/**\n * TypeScript file extension regex\n * Match .ts / .cts / .mts extensions with an optional ?query suffix.\n * Reject .tsx — and any other `.ts<letter>…` extension like .tsrx — via\n * a negative-lookahead on a following ASCII letter, so only genuine TS\n * files pass.\n *\n * Previous form `/\\.[cm]?(ts)[^x]?\\??/` was intended to exclude `.tsx`\n * specifically (`[^x]?` = not-an-x), but the `?` quantifier also allows\n * zero characters, and any non-`x` letter was admitted — so `.tsrx`\n * and similar extensions matched by accident.\n */\nexport const TS_EXT_REGEX = /\\.[cm]?ts(?![a-z])/;\n\n/**\n * Resolves whether Angular should be compiled for production. An explicit\n * `development` mode wins over an ambient production `NODE_ENV` (e.g. set by\n * `storybook build` at CLI entry), so a build can opt into Angular's\n * development compilation. See #2458 and #2462.\n */\nexport function isProdMode(mode: string | undefined): boolean {\n  if (mode === 'development') {\n    return false;\n  }\n\n  return mode === 'production' || process.env['NODE_ENV'] === 'production';\n}\n\nexport interface TsConfigResolutionContext {\n  root: string;\n  isProd: boolean;\n  isLib: boolean;\n}\n\nexport function getTsConfigPath(\n  root: string,\n  tsconfig: string,\n  isProd: boolean,\n  isTest: boolean,\n  isLib: boolean,\n  workspaceRoot?: string,\n) {\n  if (tsconfig && isAbsolute(tsconfig)) {\n    if (!existsSync(tsconfig)) {\n      console.error(\n        `[@analogjs/vite-plugin-angular]: Unable to resolve tsconfig at ${tsconfig}. This causes compilation issues. Check the path or set the \"tsconfig\" property with an absolute path.`,\n      );\n    }\n\n    return tsconfig;\n  }\n\n  let tsconfigFilePath = './tsconfig.app.json';\n\n  if (isLib) {\n    tsconfigFilePath = isProd\n      ? './tsconfig.lib.prod.json'\n      : './tsconfig.lib.json';\n  }\n\n  if (isTest) {\n    tsconfigFilePath = './tsconfig.spec.json';\n  }\n\n  if (tsconfig) {\n    tsconfigFilePath = tsconfig;\n  }\n\n  const resolvedPath = resolve(root, tsconfigFilePath);\n\n  if (existsSync(resolvedPath)) {\n    return resolvedPath;\n  }\n\n  // Callers such as Storybook's Angular builder document their `tsConfig` as\n  // workspace-relative while setting the Vite root to the project directory,\n  // so the path joins onto the project root twice. Fall back to the workspace\n  // root before failing.\n  const workspacePath = workspaceRoot\n    ? resolve(workspaceRoot, tsconfigFilePath)\n    : undefined;\n\n  if (workspacePath && existsSync(workspacePath)) {\n    return workspacePath;\n  }\n\n  const attemptedPaths =\n    workspacePath && workspacePath !== resolvedPath\n      ? `${resolvedPath} or ${workspacePath}`\n      : resolvedPath;\n\n  console.error(\n    `[@analogjs/vite-plugin-angular]: Unable to resolve tsconfig at ${attemptedPaths}. This causes compilation issues. Check the path or set the \"tsconfig\" property with an absolute path.`,\n  );\n\n  return resolvedPath;\n}\n\nexport function createTsConfigGetter(\n  tsconfigOrGetter?: string | (() => string),\n) {\n  if (typeof tsconfigOrGetter === 'function') {\n    return tsconfigOrGetter;\n  }\n\n  return () => tsconfigOrGetter || '';\n}\n\nexport interface DepOptimizerOptions {\n  tsconfig: string;\n  isProd: boolean;\n  jit: boolean;\n  watchMode: boolean;\n  isTest: boolean;\n  isAstroIntegration: boolean;\n}\n\nexport function createDepOptimizerConfig(opts: DepOptimizerOptions) {\n  const defineOptions = {\n    ngJitMode: 'false',\n    ngI18nClosureMode: 'false',\n    ...(opts.watchMode ? {} : { ngDevMode: 'false' }),\n  };\n\n  // Persist linked dependency output across dep-optimizer runs. The\n  // transformer's own key covers file bytes + options, and the directory\n  // is namespaced by Angular version, so entries never go stale.\n  const transformCacheDir = resolveTransformCacheDir(dirname(opts.tsconfig));\n  const transformCache = transformCacheDir\n    ? createPersistentTransformCache(transformCacheDir)\n    : undefined;\n\n  const rolldownOptions: vite.DepOptimizationOptions['rolldownOptions'] = {\n    plugins: [\n      createRolldownCompilerPlugin(\n        {\n          tsconfig: opts.tsconfig,\n          sourcemap: !opts.isProd,\n          advancedOptimizations: opts.isProd,\n          jit: opts.jit,\n          incremental: opts.watchMode,\n        },\n        opts.isTest,\n        !opts.isAstroIntegration,\n        transformCache,\n      ),\n    ],\n  };\n\n  const esbuildOptions: vite.DepOptimizationOptions['esbuildOptions'] = {\n    plugins: [\n      createCompilerPlugin(\n        {\n          tsconfig: opts.tsconfig,\n          sourcemap: !opts.isProd,\n          advancedOptimizations: opts.isProd,\n          jit: opts.jit,\n          incremental: opts.watchMode,\n        },\n        opts.isTest,\n        !opts.isAstroIntegration,\n        transformCache,\n      ),\n    ],\n    define: defineOptions,\n  };\n\n  // No top-level `resolve` block: the `style` package-export condition\n  // is now scoped to `.css`-extension requests via\n  // `cssExtensionStyleResolverPlugin`, so this dep optimizer config no\n  // longer needs to leak it into Vite's global `resolve.conditions`.\n  return {\n    optimizeDeps: {\n      include: ['rxjs/operators', 'rxjs'],\n      exclude: ['@angular/platform-server'],\n      ...(vite.rolldownVersion ? { rolldownOptions } : { esbuildOptions }),\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,IAAa,eAAe;;;;;;;AAQ5B,SAAgB,WAAW,MAAmC;AAC5D,KAAI,SAAS,cACX,QAAO;AAGT,QAAO,SAAS,gBAAA,QAAA,IAAA,aAA4C;;AAS9D,SAAgB,gBACd,MACA,UACA,QACA,QACA,OACA,eACA;AACA,KAAI,YAAY,WAAW,SAAS,EAAE;AACpC,MAAI,CAAC,WAAW,SAAS,CACvB,SAAQ,MACN,kEAAkE,SAAS,wGAC5E;AAGH,SAAO;;CAGT,IAAI,mBAAmB;AAEvB,KAAI,MACF,oBAAmB,SACf,6BACA;AAGN,KAAI,OACF,oBAAmB;AAGrB,KAAI,SACF,oBAAmB;CAGrB,MAAM,eAAe,QAAQ,MAAM,iBAAiB;AAEpD,KAAI,WAAW,aAAa,CAC1B,QAAO;CAOT,MAAM,gBAAgB,gBAClB,QAAQ,eAAe,iBAAiB,GACxC,KAAA;AAEJ,KAAI,iBAAiB,WAAW,cAAc,CAC5C,QAAO;CAGT,MAAM,iBACJ,iBAAiB,kBAAkB,eAC/B,GAAG,aAAa,MAAM,kBACtB;AAEN,SAAQ,MACN,kEAAkE,eAAe,wGAClF;AAED,QAAO;;AAGT,SAAgB,qBACd,kBACA;AACA,KAAI,OAAO,qBAAqB,WAC9B,QAAO;AAGT,cAAa,oBAAoB;;AAYnC,SAAgB,yBAAyB,MAA2B;CAClE,MAAM,gBAAgB;EACpB,WAAW;EACX,mBAAmB;EACnB,GAAI,KAAK,YAAY,EAAE,GAAG,EAAE,WAAW,SAAS;EACjD;CAKD,MAAM,oBAAoB,yBAAyB,QAAQ,KAAK,SAAS,CAAC;CAC1E,MAAM,iBAAiB,oBACnB,+BAA+B,kBAAkB,GACjD,KAAA;CAEJ,MAAM,kBAAkE,EACtE,SAAS,CACP,6BACE;EACE,UAAU,KAAK;EACf,WAAW,CAAC,KAAK;EACjB,uBAAuB,KAAK;EAC5B,KAAK,KAAK;EACV,aAAa,KAAK;EACnB,EACD,KAAK,QACL,CAAC,KAAK,oBACN,eACD,CACF,EACF;CAED,MAAM,iBAAgE;EACpE,SAAS,CACP,qBACE;GACE,UAAU,KAAK;GACf,WAAW,CAAC,KAAK;GACjB,uBAAuB,KAAK;GAC5B,KAAK,KAAK;GACV,aAAa,KAAK;GACnB,EACD,KAAK,QACL,CAAC,KAAK,oBACN,eACD,CACF;EACD,QAAQ;EACT;AAMD,QAAO,EACL,cAAc;EACZ,SAAS,CAAC,kBAAkB,OAAO;EACnC,SAAS,CAAC,2BAA2B;EACrC,GAAI,KAAK,kBAAkB,EAAE,iBAAiB,GAAG,EAAE,gBAAgB;EACpE,EACF"}

package/src/lib/utils/rolldown.d.ts

@@ -1,2 +1,2 @@
 export declare function isRolldown(): boolean;
-export declare function getJsTransformConfigKey(): 'oxc' | 'esbuild';
+export declare function getJsTransformConfigKey(): "oxc" | "esbuild";