@analogjs/vite-plugin-angular 3.0.0-alpha.7 → 3.0.0-alpha.71

package/src/lib/utils/compilation-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compilation-shared.js","names":[],"sources":["../../../../src/lib/utils/compilation-shared.ts"],"sourcesContent":["/**\n * Shared utilities used by both angular-vite-plugin.ts and\n * compilation-api/compilation-api-plugin.ts.\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { basename, isAbsolute, resolve } from 'node:path';\nimport { createHash } from 'node:crypto';\nimport { normalizePath } from 'vite';\n\nimport {\n  AnalogStylesheetRegistry,\n  preprocessStylesheetResult,\n  rewriteRelativeCssImports,\n} from '../stylesheet-registry.js';\nimport { normalizeStylesheetDependencies } from '../style-preprocessor.js';\nimport type { StylePreprocessor } from '../style-preprocessor.js';\nimport type { FileReplacement } from '../plugins/file-replacements.plugin.js';\nimport { debugStylesV } from './debug.js';\n\nexport enum DiagnosticModes {\n  None = 0,\n  Option = 1 << 0,\n  Syntactic = 1 << 1,\n  Semantic = 1 << 2,\n  All = Option | Syntactic | Semantic,\n}\n\nexport function injectViteIgnoreForHmrMetadata(code: string): string {\n  let patched = code.replace(\n    /\\bimport\\(([a-zA-Z_$][\\w$]*\\.\\u0275\\u0275getReplaceMetadataURL)/g,\n    'import(/* @vite-ignore */ $1',\n  );\n\n  if (patched === code) {\n    patched = patched.replace(\n      /import\\((\\S+getReplaceMetadataURL)/g,\n      'import(/* @vite-ignore */ $1',\n    );\n  }\n\n  return patched;\n}\n\nexport function isIgnoredHmrFile(file: string): boolean {\n  return file.endsWith('.tsbuildinfo');\n}\n\n/**\n * Convert Analog/Angular CLI-style file replacements into the flat record\n * expected by `AngularHostOptions.fileReplacements`.\n *\n * Only browser replacements (`{ replace, with }`) are converted. SSR-only\n * replacements (`{ replace, ssr }`) are left for the Vite runtime plugin to\n * handle — they should not be baked into the Angular compilation host because\n * that would apply them to both browser and server builds.\n *\n * Relative paths are resolved against `workspaceRoot` so that the host\n * receives the same absolute paths it would get from the Angular CLI.\n */\nexport function toAngularCompilationFileReplacements(\n  replacements: FileReplacement[],\n  workspaceRoot: string,\n): Record<string, string> | undefined {\n  const mappedReplacements = replacements.flatMap((replacement) => {\n    if (!('with' in replacement)) {\n      return [];\n    }\n\n    return [\n      [\n        isAbsolute(replacement.replace)\n          ? replacement.replace\n          : resolve(workspaceRoot, replacement.replace),\n        isAbsolute(replacement.with)\n          ? replacement.with\n          : resolve(workspaceRoot, replacement.with),\n      ] as const,\n    ];\n  });\n\n  return mappedReplacements.length\n    ? Object.fromEntries(mappedReplacements)\n    : undefined;\n}\n\n/**\n * Map Angular's `templateUpdates` (keyed by `encodedFilePath@ClassName`)\n * back to absolute file paths with their associated HMR code and component\n * class name.\n *\n * Angular's private Compilation API emits template update keys in the form\n * `encodeURIComponent(relativePath + '@' + className)`. We decode and resolve\n * them so the caller can look up updates by the same normalized absolute path\n * used elsewhere in the plugin (`outputFiles`, `classNames`, etc.).\n */\nexport function mapTemplateUpdatesToFiles(\n  templateUpdates: ReadonlyMap<string, string> | undefined,\n): Map<\n  string,\n  {\n    className: string;\n    code: string;\n  }\n> {\n  const updatesByFile = new Map<string, { className: string; code: string }>();\n\n  templateUpdates?.forEach((code, encodedUpdateId) => {\n    const [file, className = ''] =\n      decodeURIComponent(encodedUpdateId).split('@');\n    const resolvedFile = normalizePath(resolve(process.cwd(), file));\n\n    updatesByFile.set(resolvedFile, {\n      className,\n      code,\n    });\n  });\n\n  return updatesByFile;\n}\n\nexport function describeStylesheetContent(code: string): {\n  length: number;\n  digest: string;\n  preview: string;\n} {\n  return {\n    length: code.length,\n    digest: createHash('sha256').update(code).digest('hex').slice(0, 12),\n    preview: code.replace(/\\s+/g, ' ').trim().slice(0, 160),\n  };\n}\n\n/**\n * Refreshes any already-served stylesheet records that map back to a changed\n * source file.\n *\n * This is the critical bridge for externalized Angular component styles during\n * HMR. Angular's resource watcher can notice that `/src/...component.css`\n * changed before Angular recompilation has had a chance to repopulate the\n * stylesheet registry. If we emit a CSS update against the existing virtual\n * stylesheet id without first refreshing the registry content, the browser gets\n * a hot update containing stale CSS. By rewriting the existing served records\n * from disk up front, HMR always pushes the latest source content.\n */\nexport function refreshStylesheetRegistryForFile(\n  file: string,\n  stylesheetRegistry?: AnalogStylesheetRegistry,\n  stylePreprocessor?: StylePreprocessor,\n): void {\n  const normalizedFile = normalizePath(file.split('?')[0]);\n  if (!stylesheetRegistry || !existsSync(normalizedFile)) {\n    return;\n  }\n\n  const publicIds = stylesheetRegistry.getPublicIdsForSource(normalizedFile);\n  if (publicIds.length === 0) {\n    return;\n  }\n\n  const rawCss = readFileSync(normalizedFile, 'utf-8');\n  const preprocessed = preprocessStylesheetResult(\n    rawCss,\n    normalizedFile,\n    stylePreprocessor,\n  );\n  const servedCss = rewriteRelativeCssImports(\n    preprocessed.code,\n    normalizedFile,\n  );\n\n  for (const publicId of publicIds) {\n    stylesheetRegistry.registerServedStylesheet(\n      {\n        publicId,\n        sourcePath: normalizedFile,\n        originalCode: rawCss,\n        normalizedCode: servedCss,\n        dependencies: normalizeStylesheetDependencies(\n          preprocessed.dependencies,\n        ),\n        diagnostics: preprocessed.diagnostics,\n        tags: preprocessed.tags,\n      },\n      [\n        normalizedFile,\n        normalizePath(normalizedFile),\n        basename(normalizedFile),\n        normalizedFile.replace(/^\\//, ''),\n      ],\n    );\n  }\n\n  debugStylesV('stylesheet registry refreshed from source file', {\n    file: normalizedFile,\n    publicIds,\n    dependencies: preprocessed.dependencies,\n    diagnostics: preprocessed.diagnostics,\n    tags: preprocessed.tags,\n    source: describeStylesheetContent(rawCss),\n    served: describeStylesheetContent(servedCss),\n  });\n}\n\n/**\n * Checks for vitest run from the command line\n * @returns boolean\n */\nexport function isTestWatchMode(args = process.argv): boolean {\n  // vitest --run\n  const hasRun = args.find((arg) => arg.includes('--run'));\n  if (hasRun) {\n    return false;\n  }\n\n  // vitest run\n  if (args.includes('run')) {\n    return false;\n  }\n\n  // vitest --no-run\n  const hasNoRun = args.find((arg) => arg.includes('--no-run'));\n  if (hasNoRun) {\n    return true;\n  }\n\n  // check for --watch=false or --no-watch\n  const hasWatch = args.find((arg) => arg.includes('watch'));\n  if (hasWatch && ['false', 'no'].some((neg) => hasWatch.includes(neg))) {\n    return false;\n  }\n\n  // check for --watch false\n  const watchIndex = args.findIndex((arg) => arg.includes('watch'));\n  const watchArg = args[watchIndex + 1];\n  if (watchArg && watchArg === 'false') {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,IAAY,kBAAL,yBAAA,iBAAA;AACL,iBAAA,gBAAA,UAAA,KAAA;AACA,iBAAA,gBAAA,YAAA,KAAA;AACA,iBAAA,gBAAA,eAAA,KAAA;AACA,iBAAA,gBAAA,cAAA,KAAA;AACA,iBAAA,gBAAA,SAAA,KAAA;;KACD;AAED,SAAgB,+BAA+B,MAAsB;CACnE,IAAI,UAAU,KAAK,QACjB,oEACA,+BACD;AAED,KAAI,YAAY,KACd,WAAU,QAAQ,QAChB,uCACA,+BACD;AAGH,QAAO;;AAGT,SAAgB,iBAAiB,MAAuB;AACtD,QAAO,KAAK,SAAS,eAAe;;;;;;;;;;;;;;AAetC,SAAgB,qCACd,cACA,eACoC;CACpC,MAAM,qBAAqB,aAAa,SAAS,gBAAgB;AAC/D,MAAI,EAAE,UAAU,aACd,QAAO,EAAE;AAGX,SAAO,CACL,CACE,WAAW,YAAY,QAAQ,GAC3B,YAAY,UACZ,QAAQ,eAAe,YAAY,QAAQ,EAC/C,WAAW,YAAY,KAAK,GACxB,YAAY,OACZ,QAAQ,eAAe,YAAY,KAAK,CAC7C,CACF;GACD;AAEF,QAAO,mBAAmB,SACtB,OAAO,YAAY,mBAAmB,GACtC,KAAA;;;;;;;;;;;;AAaN,SAAgB,0BACd,iBAOA;CACA,MAAM,gCAAgB,IAAI,KAAkD;AAE5E,kBAAiB,SAAS,MAAM,oBAAoB;EAClD,MAAM,CAAC,MAAM,YAAY,MACvB,mBAAmB,gBAAgB,CAAC,MAAM,IAAI;EAChD,MAAM,eAAe,cAAc,QAAQ,QAAQ,KAAK,EAAE,KAAK,CAAC;AAEhE,gBAAc,IAAI,cAAc;GAC9B;GACA;GACD,CAAC;GACF;AAEF,QAAO;;AAGT,SAAgB,0BAA0B,MAIxC;AACA,QAAO;EACL,QAAQ,KAAK;EACb,QAAQ,WAAW,SAAS,CAAC,OAAO,KAAK,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;EACpE,SAAS,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI;EACxD;;;;;;;;;;;;;;AAeH,SAAgB,iCACd,MACA,oBACA,mBACM;CACN,MAAM,iBAAiB,cAAc,KAAK,MAAM,IAAI,CAAC,GAAG;AACxD,KAAI,CAAC,sBAAsB,CAAC,WAAW,eAAe,CACpD;CAGF,MAAM,YAAY,mBAAmB,sBAAsB,eAAe;AAC1E,KAAI,UAAU,WAAW,EACvB;CAGF,MAAM,SAAS,aAAa,gBAAgB,QAAQ;CACpD,MAAM,eAAe,2BACnB,QACA,gBACA,kBACD;CACD,MAAM,YAAY,0BAChB,aAAa,MACb,eACD;AAED,MAAK,MAAM,YAAY,UACrB,oBAAmB,yBACjB;EACE;EACA,YAAY;EACZ,cAAc;EACd,gBAAgB;EAChB,cAAc,gCACZ,aAAa,aACd;EACD,aAAa,aAAa;EAC1B,MAAM,aAAa;EACpB,EACD;EACE;EACA,cAAc,eAAe;EAC7B,SAAS,eAAe;EACxB,eAAe,QAAQ,OAAO,GAAG;EAClC,CACF;AAGH,cAAa,kDAAkD;EAC7D,MAAM;EACN;EACA,cAAc,aAAa;EAC3B,aAAa,aAAa;EAC1B,MAAM,aAAa;EACnB,QAAQ,0BAA0B,OAAO;EACzC,QAAQ,0BAA0B,UAAU;EAC7C,CAAC;;;;;;AAOJ,SAAgB,gBAAgB,OAAO,QAAQ,MAAe;AAG5D,KADe,KAAK,MAAM,QAAQ,IAAI,SAAS,QAAQ,CAAC,CAEtD,QAAO;AAIT,KAAI,KAAK,SAAS,MAAM,CACtB,QAAO;AAKT,KADiB,KAAK,MAAM,QAAQ,IAAI,SAAS,WAAW,CAAC,CAE3D,QAAO;CAIT,MAAM,WAAW,KAAK,MAAM,QAAQ,IAAI,SAAS,QAAQ,CAAC;AAC1D,KAAI,YAAY,CAAC,SAAS,KAAK,CAAC,MAAM,QAAQ,SAAS,SAAS,IAAI,CAAC,CACnE,QAAO;CAKT,MAAM,WAAW,KADE,KAAK,WAAW,QAAQ,IAAI,SAAS,QAAQ,CAAC,GAC9B;AACnC,KAAI,YAAY,aAAa,QAC3B,QAAO;AAGT,QAAO"}

package/src/lib/utils/compiler-plugin-options.d.ts

@@ -1,13 +1,13 @@
-import { SourceFileCache } from './source-file-cache';
+import { SourceFileCache } from "./source-file-cache";
 export interface CompilerPluginOptions {
-    sourcemap: boolean;
-    tsconfig: string;
-    jit?: boolean;
-    /** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
-    noopTypeScriptCompilation?: boolean;
-    advancedOptimizations?: boolean;
-    thirdPartySourcemaps?: boolean;
-    fileReplacements?: Record<string, string>;
-    sourceFileCache?: SourceFileCache;
-    incremental: boolean;
+	sourcemap: boolean;
+	tsconfig: string;
+	jit?: boolean;
+	/** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
+	noopTypeScriptCompilation?: boolean;
+	advancedOptimizations?: boolean;
+	thirdPartySourcemaps?: boolean;
+	fileReplacements?: Record<string, string>;
+	sourceFileCache?: SourceFileCache;
+	incremental: boolean;
 }

package/src/lib/utils/css-extension-resolver.d.ts

@@ -0,0 +1,32 @@
+import * as vite from "vite";
+/**
+* Resolves bare-specifier `.css` imports with the `style` package-export
+* condition in scope, without leaking `style` into Vite's global
+* `resolve.conditions`.
+*
+* Two real cases pull in opposite directions on this condition:
+*
+*   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:
+*      Material's prebuilt theme entries are gated *only* under the `style`
+*      condition (no `default`, no `import`), so without `style` in scope
+*      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+*
+*   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS
+*      plugin resolver inherits Vite's global conditions. If `style` is
+*      injected globally, that resolver matches the package's `style`
+*      export (a `.css` file) and feeds it to Node's ESM loader, which
+*      can't load `.css` and throws
+*      `Internal server error: Unknown file extension ".css"`.
+*
+* The fix: scope the `style` condition to requests that *look* like CSS
+* assets — bare specifiers ending in `.css` (with optional query suffix
+* for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through
+* to Vite's normal resolver chain, so packages with mixed exports
+* (`tailwindcss-primeui` exposes both `style` and `import`) resolve to
+* their JS surface.
+*
+* Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes
+* `vite.createIdResolver(config, options)`. Their resolver-call signatures
+* differ — this plugin normalizes both.
+*/
+export declare function cssExtensionStyleResolverPlugin(): vite.Plugin;

package/src/lib/utils/css-extension-resolver.js

@@ -0,0 +1,73 @@
+import * as vite from "vite";
+//#region packages/vite-plugin-angular/src/lib/utils/css-extension-resolver.ts
+/**
+* Resolves bare-specifier `.css` imports with the `style` package-export
+* condition in scope, without leaking `style` into Vite's global
+* `resolve.conditions`.
+*
+* Two real cases pull in opposite directions on this condition:
+*
+*   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:
+*      Material's prebuilt theme entries are gated *only* under the `style`
+*      condition (no `default`, no `import`), so without `style` in scope
+*      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+*
+*   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS
+*      plugin resolver inherits Vite's global conditions. If `style` is
+*      injected globally, that resolver matches the package's `style`
+*      export (a `.css` file) and feeds it to Node's ESM loader, which
+*      can't load `.css` and throws
+*      `Internal server error: Unknown file extension ".css"`.
+*
+* The fix: scope the `style` condition to requests that *look* like CSS
+* assets — bare specifiers ending in `.css` (with optional query suffix
+* for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through
+* to Vite's normal resolver chain, so packages with mixed exports
+* (`tailwindcss-primeui` exposes both `style` and `import`) resolve to
+* their JS surface.
+*
+* Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes
+* `vite.createIdResolver(config, options)`. Their resolver-call signatures
+* differ — this plugin normalizes both.
+*/
+function cssExtensionStyleResolverPlugin() {
+	let resolveCss;
+	return {
+		name: "@analogjs/vite-plugin-angular:css-style-resolver",
+		enforce: "pre",
+		configResolved(config) {
+			const styleResolveOptions = {
+				...config.resolve,
+				conditions: [...config.resolve.conditions ?? [], "style"]
+			};
+			const createIdResolver = vite.createIdResolver;
+			if (typeof createIdResolver === "function") {
+				const r = createIdResolver(config, styleResolveOptions);
+				resolveCss = async (id, importer, environment) => {
+					return await r(environment ?? { name: "client" }, id, importer, false);
+				};
+				return;
+			}
+			const legacyCreateResolver = config.createResolver;
+			if (typeof legacyCreateResolver === "function") {
+				const r = legacyCreateResolver(styleResolveOptions);
+				resolveCss = async (id, importer) => {
+					return await r(id, importer, false, false);
+				};
+				return;
+			}
+			throw new Error("[@analogjs/vite-plugin-angular]: neither vite.createIdResolver (Vite 8) nor ResolvedConfig.createResolver (Vite 7) is available. Unsupported Vite version.");
+		},
+		async resolveId(id, importer) {
+			if (!resolveCss) return null;
+			if (id.startsWith(".") || id.startsWith("/") || /^[A-Za-z]:\//.test(id) || id.startsWith("\0") || id.startsWith("data:") || id.startsWith("virtual:")) return null;
+			if (!/\.css(?:\?|$)/.test(id)) return null;
+			const env = this.environment;
+			return await resolveCss(id, importer, env) ?? null;
+		}
+	};
+}
+//#endregion
+export { cssExtensionStyleResolverPlugin };
+
+//# sourceMappingURL=css-extension-resolver.js.map

package/src/lib/utils/css-extension-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-extension-resolver.js","names":[],"sources":["../../../../src/lib/utils/css-extension-resolver.ts"],"sourcesContent":["import * as vite from 'vite';\n\ntype CssResolver = (\n  id: string,\n  importer: string | undefined,\n  environment?: { name: string } | undefined,\n) => Promise<string | undefined>;\n\n/**\n * Resolves bare-specifier `.css` imports with the `style` package-export\n * condition in scope, without leaking `style` into Vite's global\n * `resolve.conditions`.\n *\n * Two real cases pull in opposite directions on this condition:\n *\n *   1. `import '@angular/material/prebuilt-themes/azure-blue.css'` from TS:\n *      Material's prebuilt theme entries are gated *only* under the `style`\n *      condition (no `default`, no `import`), so without `style` in scope\n *      the request fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.\n *\n *   2. `@plugin 'tailwindcss-primeui'` from a CSS file: Tailwind v4's JS\n *      plugin resolver inherits Vite's global conditions. If `style` is\n *      injected globally, that resolver matches the package's `style`\n *      export (a `.css` file) and feeds it to Node's ESM loader, which\n *      can't load `.css` and throws\n *      `Internal server error: Unknown file extension \".css\"`.\n *\n * The fix: scope the `style` condition to requests that *look* like CSS\n * assets — bare specifiers ending in `.css` (with optional query suffix\n * for `?inline`, `?module`, etc.). Non-CSS bare specifiers fall through\n * to Vite's normal resolver chain, so packages with mixed exports\n * (`tailwindcss-primeui` exposes both `style` and `import`) resolve to\n * their JS surface.\n *\n * Vite 7 exposes `ResolvedConfig.createResolver(options)`; Vite 8 exposes\n * `vite.createIdResolver(config, options)`. Their resolver-call signatures\n * differ — this plugin normalizes both.\n */\nexport function cssExtensionStyleResolverPlugin(): vite.Plugin {\n  let resolveCss: CssResolver | undefined;\n\n  return {\n    name: '@analogjs/vite-plugin-angular:css-style-resolver',\n    enforce: 'pre',\n\n    configResolved(config) {\n      const styleResolveOptions = {\n        ...config.resolve,\n        conditions: [...(config.resolve.conditions ?? []), 'style'],\n      };\n\n      const createIdResolver = (\n        vite as unknown as {\n          createIdResolver?: (\n            c: vite.ResolvedConfig,\n            o: typeof styleResolveOptions,\n          ) => (\n            environment: { name: string },\n            id: string,\n            importer: string | undefined,\n            ssr: boolean,\n          ) => Promise<string | undefined>;\n        }\n      ).createIdResolver;\n\n      if (typeof createIdResolver === 'function') {\n        const r = createIdResolver(config, styleResolveOptions);\n        resolveCss = async (id, importer, environment) => {\n          return await r(\n            environment ?? { name: 'client' },\n            id,\n            importer,\n            false,\n          );\n        };\n        return;\n      }\n\n      const legacyCreateResolver = (\n        config as unknown as {\n          createResolver?: (\n            o: typeof styleResolveOptions,\n          ) => (\n            id: string,\n            importer: string | undefined,\n            aliasOnly: boolean,\n            ssr: boolean,\n          ) => Promise<string | undefined>;\n        }\n      ).createResolver;\n\n      if (typeof legacyCreateResolver === 'function') {\n        const r = legacyCreateResolver(styleResolveOptions);\n        resolveCss = async (id, importer) => {\n          return await r(id, importer, false, false);\n        };\n        return;\n      }\n\n      // Both APIs have been stable across the supported Vite range\n      // (7.x via `ResolvedConfig.createResolver`, 8.x via\n      // `vite.createIdResolver`). If neither is present, fail loudly\n      // rather than silently regressing CSS imports of `style`-only\n      // package exports such as `@angular/material/prebuilt-themes/*`.\n      throw new Error(\n        '[@analogjs/vite-plugin-angular]: neither vite.createIdResolver ' +\n          '(Vite 8) nor ResolvedConfig.createResolver (Vite 7) is available. ' +\n          'Unsupported Vite version.',\n      );\n    },\n\n    async resolveId(id, importer) {\n      if (!resolveCss) return null;\n\n      // Skip non-bare specifiers — relative, absolute, virtual, and\n      // data-URI imports don't consult package exports, so the `style`\n      // condition is irrelevant for them.\n      if (\n        id.startsWith('.') ||\n        id.startsWith('/') ||\n        /^[A-Za-z]:\\//.test(id) ||\n        id.startsWith('\\0') ||\n        id.startsWith('data:') ||\n        id.startsWith('virtual:')\n      ) {\n        return null;\n      }\n\n      // Only fire on `.css` requests (with optional query, e.g. `?inline`,\n      // `?module`). Non-CSS bare specifiers go through Vite's normal\n      // resolver chain unchanged, which is critical for packages whose\n      // exports include both `style` and `import`/`default` — e.g.\n      // `tailwindcss-primeui`, where `@plugin` resolution must land on\n      // the JS file, not the CSS file.\n      if (!/\\.css(?:\\?|$)/.test(id)) return null;\n\n      const env = (this as unknown as { environment?: { name: string } })\n        .environment;\n      const resolved = await resolveCss(id, importer, env);\n      return resolved ?? null;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,kCAA+C;CAC7D,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,SAAS;EAET,eAAe,QAAQ;GACrB,MAAM,sBAAsB;IAC1B,GAAG,OAAO;IACV,YAAY,CAAC,GAAI,OAAO,QAAQ,cAAc,EAAE,EAAG,QAAQ;IAC5D;GAED,MAAM,mBACJ,KAWA;AAEF,OAAI,OAAO,qBAAqB,YAAY;IAC1C,MAAM,IAAI,iBAAiB,QAAQ,oBAAoB;AACvD,iBAAa,OAAO,IAAI,UAAU,gBAAgB;AAChD,YAAO,MAAM,EACX,eAAe,EAAE,MAAM,UAAU,EACjC,IACA,UACA,MACD;;AAEH;;GAGF,MAAM,uBACJ,OAUA;AAEF,OAAI,OAAO,yBAAyB,YAAY;IAC9C,MAAM,IAAI,qBAAqB,oBAAoB;AACnD,iBAAa,OAAO,IAAI,aAAa;AACnC,YAAO,MAAM,EAAE,IAAI,UAAU,OAAO,MAAM;;AAE5C;;AAQF,SAAM,IAAI,MACR,6JAGD;;EAGH,MAAM,UAAU,IAAI,UAAU;AAC5B,OAAI,CAAC,WAAY,QAAO;AAKxB,OACE,GAAG,WAAW,IAAI,IAClB,GAAG,WAAW,IAAI,IAClB,eAAe,KAAK,GAAG,IACvB,GAAG,WAAW,KAAK,IACnB,GAAG,WAAW,QAAQ,IACtB,GAAG,WAAW,WAAW,CAEzB,QAAO;AAST,OAAI,CAAC,gBAAgB,KAAK,GAAG,CAAE,QAAO;GAEtC,MAAM,MAAO,KACV;AAEH,UADiB,MAAM,WAAW,IAAI,UAAU,IAAI,IACjC;;EAEtB"}

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,28 @@
+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 debugEmit: unknown;
+export declare const debugStylePipeline: unknown;
+export declare const debugTailwindV: 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" | "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[];
+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,39 @@
+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 debugEmit = createDebug("analog:angular:emit");
+var debugStylePipeline = createDebug("analog:angular:style-pipeline");
+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 debugEmitV = createDebug("analog:angular:emit:v");
+var harness = createDebugHarness({
+	fallbackNamespace: "analog:angular:*",
+	instanceGroups: [[
+		debugTailwind,
+		debugHmr,
+		debugStyles,
+		debugCompiler,
+		debugCompilationApi,
+		debugEmit,
+		debugStylePipeline,
+		debugTailwindV,
+		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, debugTailwind, debugTailwindV };
+
+//# 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 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);\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 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');\nexport const debugEmitV = createDebug('analog:angular:emit:v');\n\nconst angularDebugInstances = [\n  debugTailwind,\n  debugHmr,\n  debugStyles,\n  debugCompiler,\n  debugCompilationApi,\n  debugEmit,\n  debugStylePipeline,\n  debugTailwindV,\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  | '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;AACD,IAAa,YAAY,YAAY,sBAAsB;AAC3D,IAAa,qBAAqB,YAAY,gCAAgC;AAG9E,IAAa,iBAAiB,YAAY,4BAA4B;AACtE,IAAa,YAAY,YAAY,uBAAuB;AAC5D,IAAa,eAAe,YAAY,0BAA0B;AAClE,IAAa,iBAAiB,YAAY,4BAA4B;AACtE,IAAa,aAAa,YAAY,wBAAwB;AAoD9D,IAAM,UAAU,mBAAmB;CACjC,mBAAmB;CACnB,gBAAgB,CApDY;EAC5B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAuCwC;CACxC,CAAC;AAEF,IAAa,mBAGD,QAAQ;AACpB,IAAa,wBACX,QAAQ;AACqC,QAAQ"}

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

@@ -1,10 +1,10 @@
-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 { CompilerPluginOptions } from "./compiler-plugin-options.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, };
+export { cjt as createJitResourceTransformer, jt as JavaScriptTransformer, sourceFileCache as SourceFileCache, CompilerPluginOptions, angularMajor, angularMinor, angularPatch, createAngularCompilation, angularFullVersion };

package/src/lib/utils/devkit.js

@@ -1,41 +1,37 @@
-import { VERSION } from '@angular/compiler-cli';
-import { createRequire } from 'node:module';
-import * as sfc from './source-file-cache.js';
-const require = createRequire(import.meta.url);
-const angularMajor = Number(VERSION.major);
-const angularMinor = Number(VERSION.minor);
-const angularPatch = Number(VERSION.patch);
-const padVersion = (version) => String(version).padStart(2, '0');
-const angularFullVersion = Number(`${angularMajor}${padVersion(angularMinor)}${padVersion(angularPatch)}`);
-let sourceFileCache;
-let cjt;
-let jt;
-let createAngularCompilation;
-if (angularMajor < 17) {
-    throw new Error('AnalogJS is not compatible with Angular v16 and lower');
-}
+import { SourceFileCache } from "./source-file-cache.js";
+import { VERSION } from "@angular/compiler-cli";
+import { createRequire } from "node:module";
+//#region packages/vite-plugin-angular/src/lib/utils/devkit.ts
+var require = createRequire(import.meta.url);
+var angularMajor = Number(VERSION.major);
+var angularMinor = Number(VERSION.minor);
+var angularPatch = Number(VERSION.patch);
+var padVersion = (version) => String(version).padStart(2, "0");
+var angularFullVersion = Number(`${angularMajor}${padVersion(angularMinor)}${padVersion(angularPatch)}`);
+var sourceFileCache;
+var cjt;
+var jt;
+var createAngularCompilation;
+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');
-    const { createJitResourceTransformer, } = require('@angular-devkit/build-angular/src/tools/esbuild/angular/jit-resource-transformer.js');
-    const { JavaScriptTransformer, } = require('@angular-devkit/build-angular/src/tools/esbuild/javascript-transformer.js');
-    /**
-     * Workaround for compatibility with Angular 17.0+
-     */
-    if (typeof cp['SourceFileCache'] !== 'undefined') {
-        sourceFileCache = cp.SourceFileCache;
-    }
-    else {
-        sourceFileCache = sfc.SourceFileCache;
-    }
-    cjt = createJitResourceTransformer;
-    jt = JavaScriptTransformer;
-}
-else {
-    const { createJitResourceTransformer, JavaScriptTransformer, SourceFileCache, createAngularCompilation: createAngularCompilationFn, } = require('@angular/build/private');
-    sourceFileCache = SourceFileCache;
-    cjt = createJitResourceTransformer;
-    jt = JavaScriptTransformer;
-    createAngularCompilation = createAngularCompilationFn;
+	const cp = require("@angular-devkit/build-angular/src/tools/esbuild/angular/compiler-plugin.js");
+	const { createJitResourceTransformer } = require("@angular-devkit/build-angular/src/tools/esbuild/angular/jit-resource-transformer.js");
+	const { JavaScriptTransformer } = require("@angular-devkit/build-angular/src/tools/esbuild/javascript-transformer.js");
+	/**
+	* Workaround for compatibility with Angular 17.0+
+	*/
+	if (typeof cp["SourceFileCache"] !== "undefined") sourceFileCache = cp.SourceFileCache;
+	else sourceFileCache = SourceFileCache;
+	cjt = createJitResourceTransformer;
+	jt = JavaScriptTransformer;
+} else {
+	const { createJitResourceTransformer, JavaScriptTransformer, SourceFileCache, createAngularCompilation: createAngularCompilationFn } = require("@angular/build/private");
+	sourceFileCache = SourceFileCache;
+	cjt = createJitResourceTransformer;
+	jt = JavaScriptTransformer;
+	createAngularCompilation = createAngularCompilationFn;
 }
-export { cjt as createJitResourceTransformer, jt as JavaScriptTransformer, sourceFileCache as SourceFileCache, angularMajor, angularMinor, angularPatch, createAngularCompilation, angularFullVersion, };
+//#endregion
+export { angularFullVersion, cjt, createAngularCompilation, jt, sourceFileCache };
+
 //# sourceMappingURL=devkit.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"devkit.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-angular/src/lib/utils/devkit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,GAAG,MAAM,wBAAwB,CAAC;AAE9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,YAAY,GAAW,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACnD,MAAM,YAAY,GAAW,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACnD,MAAM,YAAY,GAAW,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACnD,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzE,MAAM,kBAAkB,GAAW,MAAM,CACvC,GAAG,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,EAAE,CACxE,CAAC;AACF,IAAI,eAAoB,CAAC;AACzB,IAAI,GAA4B,CAAC;AACjC,IAAI,EAAO,CAAC;AACZ,IAAI,wBAAiD,CAAC;AAEtD,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;IACtB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;AAC3E,CAAC;KAAM,IAAI,YAAY,IAAI,EAAE,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;IACnD,MAAM,EAAE,GAAG,OAAO,CAAC,4EAA4E,CAAC,CAAC;IACjG,MAAM,EACJ,4BAA4B,GAC7B,GAAG,OAAO,CAAC,qFAAqF,CAAC,CAAC;IACnG,MAAM,EACJ,qBAAqB,GACtB,GAAG,OAAO,CAAC,2EAA2E,CAAC,CAAC;IAEzF;;OAEG;IACH,IAAI,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,WAAW,EAAE,CAAC;QACjD,eAAe,GAAG,EAAE,CAAC,eAAe,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;IACxC,CAAC;IAED,GAAG,GAAG,4BAA4B,CAAC;IACnC,EAAE,GAAG,qBAAqB,CAAC;AAC7B,CAAC;KAAM,CAAC;IACN,MAAM,EACJ,4BAA4B,EAC5B,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EAAE,0BAA0B,GACrD,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEtC,eAAe,GAAG,eAAe,CAAC;IAClC,GAAG,GAAG,4BAA4B,CAAC;IACnC,EAAE,GAAG,qBAAqB,CAAC;IAC3B,wBAAwB,GAAG,0BAA0B,CAAC;AACxD,CAAC;AAED,OAAO,EACL,GAAG,IAAI,4BAA4B,EACnC,EAAE,IAAI,qBAAqB,EAC3B,eAAe,IAAI,eAAe,EAElC,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,GACnB,CAAC"}
+{"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"}