@analogjs/vite-plugin-angular 3.0.0-alpha.23 → 3.0.0-alpha.25

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

@@ -1,39 +1,25 @@
+export declare const debugTailwind: unknown;
 export declare const debugHmr: unknown;
 export declare const debugStyles: unknown;
 export declare const debugCompiler: unknown;
 export declare const debugCompilationApi: unknown;
-export declare const debugTailwind: unknown;
-export type DebugScope = "analog:angular:*" | "analog:angular:hmr" | "analog:angular:styles" | "analog:angular:compiler" | "analog:angular:compilation-api" | "analog:angular:tailwind" | (string & {});
+export declare const debugTailwindV: unknown;
+export declare const debugHmrV: unknown;
+export declare const debugStylesV: unknown;
+export declare const debugCompilerV: 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:tailwind" | "analog:angular:tailwind:v" | (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[];
-/**
-* Translates the user-facing `debug` plugin option into obug namespace
-* activations.  Called once during the Vite plugin config hook.
-*
-* Additive — does not replace namespaces already enabled via the DEBUG
-* env var or localStorage.debug.
-*
-* When an object with `mode` is provided, activation is deferred until
-* {@link activateDeferredDebug} is called from a Vite config hook.
-*
-* Accepts an array of objects to enable different scopes per command:
-* ```ts
-* debug: [
-*   { scopes: ['analog:angular:hmr'], mode: 'dev' },
-*   { scopes: ['analog:angular:compiler'], mode: 'build' },
-* ]
-* ```
-*/
-export declare function applyDebugOption(debug: DebugOption | undefined): void;
-/**
-* Called from a Vite config hook once `command` is known.
-* Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.
-* Idempotent — clears pending state after the first call.
-*/
-export declare function activateDeferredDebug(command: "build" | "serve"): void;
-/** @internal test-only reset */
-export declare function _resetDeferredDebug(): void;
+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

@@ -1,74 +1,33 @@
-import { createDebug, enable } from "obug";
+import { createDebugHarness } from "./debug-harness.js";
+import { createDebug } from "obug";
 //#region packages/vite-plugin-angular/src/lib/utils/debug.ts
+var debugTailwind = createDebug("analog:angular:tailwind");
 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 debugTailwind = createDebug("analog:angular:tailwind");
-var pendingDebug = [];
-function resolveNamespaces(scopes, fallback) {
-	if (scopes === true || scopes === void 0) return fallback;
-	if (Array.isArray(scopes) && scopes.length) return scopes.join(",");
-	return null;
-}
-function applyEntry(entry, fallback) {
-	if (!entry.mode) {
-		const ns = resolveNamespaces(entry.scopes ?? true, fallback);
-		if (ns) enable(ns);
-	} else pendingDebug.push(entry);
-}
-/**
-* Translates the user-facing `debug` plugin option into obug namespace
-* activations.  Called once during the Vite plugin config hook.
-*
-* Additive — does not replace namespaces already enabled via the DEBUG
-* env var or localStorage.debug.
-*
-* When an object with `mode` is provided, activation is deferred until
-* {@link activateDeferredDebug} is called from a Vite config hook.
-*
-* Accepts an array of objects to enable different scopes per command:
-* ```ts
-* debug: [
-*   { scopes: ['analog:angular:hmr'], mode: 'dev' },
-*   { scopes: ['analog:angular:compiler'], mode: 'build' },
-* ]
-* ```
-*/
-function applyDebugOption(debug) {
-	if (debug == null || debug === false) return;
-	if (typeof debug === "boolean") {
-		const ns = resolveNamespaces(debug, "analog:angular:*");
-		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) applyEntry(entry, "analog:angular:*");
-		return;
-	}
-	applyEntry(debug, "analog:angular:*");
-}
-/**
-* Called from a Vite config hook once `command` is known.
-* Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.
-* Idempotent — clears pending state after the first call.
-*/
-function activateDeferredDebug(command) {
-	if (pendingDebug.length === 0) return;
-	const currentMode = command === "serve" ? "dev" : "build";
-	for (const entry of pendingDebug) if (entry.mode === currentMode) {
-		const ns = resolveNamespaces(entry.scopes ?? true, "analog:angular:*");
-		if (ns) enable(ns);
-	}
-	pendingDebug = [];
-}
+var debugTailwindV = createDebug("analog:angular:tailwind:v");
+var debugHmrV = createDebug("analog:angular:hmr:v");
+var debugStylesV = createDebug("analog:angular:styles:v");
+var debugCompilerV = createDebug("analog:angular:compiler:v");
+var harness = createDebugHarness({
+	fallbackNamespace: "analog:angular:*",
+	instanceGroups: [[
+		debugTailwind,
+		debugHmr,
+		debugStyles,
+		debugCompiler,
+		debugCompilationApi,
+		debugTailwindV,
+		debugHmrV,
+		debugStylesV,
+		debugCompilerV
+	]]
+});
+var applyDebugOption = harness.applyDebugOption;
+var activateDeferredDebug = harness.activateDeferredDebug;
+harness._resetDeferredDebug;
 //#endregion
-export { activateDeferredDebug, applyDebugOption, debugCompilationApi, debugCompiler, debugHmr, debugStyles, debugTailwind };
+export { activateDeferredDebug, applyDebugOption, debugCompilationApi, debugCompiler, debugCompilerV, debugHmr, debugHmrV, debugStyles, debugStylesV, debugTailwind, debugTailwindV };
 
 //# sourceMappingURL=debug.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"debug.js","names":[],"sources":["../../../../src/lib/utils/debug.ts"],"sourcesContent":["import { createDebug, enable } from 'obug';\n\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 debugTailwind = createDebug('analog:angular:tailwind');\n\nexport type DebugScope =\n  | 'analog:angular:*'\n  | 'analog:angular:hmr'\n  | 'analog:angular:styles'\n  | 'analog:angular:compiler'\n  | 'analog:angular:compilation-api'\n  | 'analog:angular:tailwind'\n  | (string & {});\n\nexport type DebugMode = 'build' | 'dev';\n\nexport interface DebugModeOptions {\n  scopes?: boolean | DebugScope[];\n  mode?: DebugMode;\n}\n\nexport type DebugOption =\n  | boolean\n  | DebugScope[]\n  | DebugModeOptions\n  | DebugModeOptions[];\n\nlet pendingDebug: DebugModeOptions[] = [];\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 applyEntry(entry: DebugModeOptions, fallback: string): void {\n  if (!entry.mode) {\n    const ns = resolveNamespaces(entry.scopes ?? true, fallback);\n    if (ns) enable(ns);\n  } else {\n    pendingDebug.push(entry);\n  }\n}\n\n/**\n * Translates the user-facing `debug` plugin option into obug namespace\n * activations.  Called once during the Vite plugin config hook.\n *\n * Additive — does not replace namespaces already enabled via the DEBUG\n * env var or localStorage.debug.\n *\n * When an object with `mode` is provided, activation is deferred until\n * {@link activateDeferredDebug} is called from a Vite config hook.\n *\n * Accepts an array of objects to enable different scopes per command:\n * ```ts\n * debug: [\n *   { scopes: ['analog:angular:hmr'], mode: 'dev' },\n *   { scopes: ['analog:angular:compiler'], mode: 'build' },\n * ]\n * ```\n */\nexport function applyDebugOption(debug: DebugOption | undefined): void {\n  if (debug == null || debug === false) return;\n\n  if (typeof debug === 'boolean') {\n    const ns = resolveNamespaces(debug, 'analog:angular:*');\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[]) {\n      applyEntry(entry, 'analog:angular:*');\n    }\n    return;\n  }\n\n  applyEntry(debug, 'analog:angular:*');\n}\n\n/**\n * Called from a Vite config hook once `command` is known.\n * Maps Vite's `'serve'` to `'dev'` and `'build'` to `'build'`.\n * Idempotent — clears pending state after the first call.\n */\nexport function activateDeferredDebug(command: 'build' | 'serve'): void {\n  if (pendingDebug.length === 0) return;\n\n  const currentMode = command === 'serve' ? 'dev' : 'build';\n\n  for (const entry of pendingDebug) {\n    if (entry.mode === currentMode) {\n      const ns = resolveNamespaces(entry.scopes ?? true, 'analog:angular:*');\n      if (ns) enable(ns);\n    }\n  }\n\n  pendingDebug = [];\n}\n\n/** @internal test-only reset */\nexport function _resetDeferredDebug(): void {\n  pendingDebug = [];\n}\n"],"mappings":";;AAEA,IAAa,WAAW,YAAY,qBAAqB;AACzD,IAAa,cAAc,YAAY,wBAAwB;AAC/D,IAAa,gBAAgB,YAAY,0BAA0B;AACnE,IAAa,sBAAsB,YACjC,iCACD;AACD,IAAa,gBAAgB,YAAY,0BAA0B;AAwBnE,IAAI,eAAmC,EAAE;AAEzC,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,WAAW,OAAyB,UAAwB;AACnE,KAAI,CAAC,MAAM,MAAM;EACf,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,SAAS;AAC5D,MAAI,GAAI,QAAO,GAAG;OAElB,cAAa,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;AAsB5B,SAAgB,iBAAiB,OAAsC;AACrE,KAAI,SAAS,QAAQ,UAAU,MAAO;AAEtC,KAAI,OAAO,UAAU,WAAW;EAC9B,MAAM,KAAK,kBAAkB,OAAO,mBAAmB;AACvD,MAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,EAAG;AAExB,MAAI,OAAO,MAAM,OAAO,UAAU;GAChC,MAAM,KAAM,MAAmB,KAAK,IAAI;AACxC,OAAI,GAAI,QAAO,GAAG;AAClB;;AAGF,OAAK,MAAM,SAAS,MAClB,YAAW,OAAO,mBAAmB;AAEvC;;AAGF,YAAW,OAAO,mBAAmB;;;;;;;AAQvC,SAAgB,sBAAsB,SAAkC;AACtE,KAAI,aAAa,WAAW,EAAG;CAE/B,MAAM,cAAc,YAAY,UAAU,QAAQ;AAElD,MAAK,MAAM,SAAS,aAClB,KAAI,MAAM,SAAS,aAAa;EAC9B,MAAM,KAAK,kBAAkB,MAAM,UAAU,MAAM,mBAAmB;AACtE,MAAI,GAAI,QAAO,GAAG;;AAItB,gBAAe,EAAE"}
+{"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 debugTailwind = createDebug('analog:angular:tailwind');\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);\n\n// Verbose — per-file detail, enable with :v suffix or parent:*\nexport const debugTailwindV = createDebug('analog:angular:tailwind:v');\nexport const debugHmrV = createDebug('analog:angular:hmr:v');\nexport const debugStylesV = createDebug('analog:angular:styles:v');\nexport const debugCompilerV = createDebug('analog:angular:compiler:v');\n\nconst angularDebugInstances = [\n  debugTailwind,\n  debugHmr,\n  debugStyles,\n  debugCompiler,\n  debugCompilationApi,\n  debugTailwindV,\n  debugHmrV,\n  debugStylesV,\n  debugCompilerV,\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:tailwind'\n  | 'analog:angular:tailwind:v'\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,gBAAgB,YAAY,0BAA0B;AACnE,IAAa,WAAW,YAAY,qBAAqB;AACzD,IAAa,cAAc,YAAY,wBAAwB;AAC/D,IAAa,gBAAgB,YAAY,0BAA0B;AACnE,IAAa,sBAAsB,YACjC,iCACD;AAGD,IAAa,iBAAiB,YAAY,4BAA4B;AACtE,IAAa,YAAY,YAAY,uBAAuB;AAC5D,IAAa,eAAe,YAAY,0BAA0B;AAClE,IAAa,iBAAiB,YAAY,4BAA4B;AA8CtE,IAAM,UAAU,mBAAmB;CACjC,mBAAmB;CACnB,gBAAgB,CA9CY;EAC5B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAoCwC;CACxC,CAAC;AAEF,IAAa,mBAGD,QAAQ;AACpB,IAAa,wBACX,QAAQ;AACqC,QAAQ"}

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

@@ -1,8 +1,8 @@
 import type { CompilerPluginOptions } from "./compiler-plugin-options.js";
-declare const angularMajor: number;
-declare const angularMinor: number;
-declare const angularPatch: number;
-declare const angularFullVersion: number;
+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;

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

@@ -1 +1 @@
-{"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 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 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(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;\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,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;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"}