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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/src/lib/utils/rolldown.js

@@ -0,0 +1,12 @@
+import * as vite from "vite";
+//#region packages/vite-plugin-angular/src/lib/utils/rolldown.ts
+function isRolldown() {
+	return !!vite.rolldownVersion;
+}
+function getJsTransformConfigKey() {
+	return isRolldown() ? "oxc" : "esbuild";
+}
+//#endregion
+export { getJsTransformConfigKey, isRolldown };
+
+//# sourceMappingURL=rolldown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.js","names":[],"sources":["../../../../src/lib/utils/rolldown.ts"],"sourcesContent":["import * as vite from 'vite';\n\nexport function isRolldown(): boolean {\n  return !!vite.rolldownVersion;\n}\n\nexport function getJsTransformConfigKey(): 'oxc' | 'esbuild' {\n  return isRolldown() ? 'oxc' : 'esbuild';\n}\n"],"mappings":";;AAEA,SAAgB,aAAsB;AACpC,QAAO,CAAC,CAAC,KAAK;;AAGhB,SAAgB,0BAA6C;AAC3D,QAAO,YAAY,GAAG,QAAQ"}

package/src/lib/utils/safe-module-paths.d.ts

@@ -0,0 +1,16 @@
+import { type ResolvedConfig } from "vite";
+/**
+* Mark a style file path as safe in Vite's `safeModulePaths` set so the
+* `?inline` import passes the Denied ID security check without needing
+* the plugin to intercept the load.
+*
+* Vite's own import-analysis transform does the same thing (adds the clean
+* URL to `safeModulePaths` during transform). We additionally add the
+* `?inline` form because `isServerAccessDeniedForTransform` checks *both*
+* `cleanUrl(id)` and the full `id` (with query) against the allow list.
+*
+* This lets `?inline` CSS flow through Vite's native CSS pipeline, which
+* handles preprocessing, `test.css` semantics, and browser-vs-node
+* differences without the plugin having to reimplement any of it.
+*/
+export declare function markStylePathSafe(config: ResolvedConfig | undefined, absPath: string): void;

package/src/lib/utils/safe-module-paths.js

@@ -0,0 +1,29 @@
+import { normalizePath } from "vite";
+//#region packages/vite-plugin-angular/src/lib/utils/safe-module-paths.ts
+/**
+* Mark a style file path as safe in Vite's `safeModulePaths` set so the
+* `?inline` import passes the Denied ID security check without needing
+* the plugin to intercept the load.
+*
+* Vite's own import-analysis transform does the same thing (adds the clean
+* URL to `safeModulePaths` during transform). We additionally add the
+* `?inline` form because `isServerAccessDeniedForTransform` checks *both*
+* `cleanUrl(id)` and the full `id` (with query) against the allow list.
+*
+* This lets `?inline` CSS flow through Vite's native CSS pipeline, which
+* handles preprocessing, `test.css` semantics, and browser-vs-node
+* differences without the plugin having to reimplement any of it.
+*/
+function markStylePathSafe(config, absPath) {
+	if (!config) return;
+	const normalized = normalizePath(absPath);
+	const safeModulePaths = config.safeModulePaths;
+	if (safeModulePaths) {
+		safeModulePaths.add(normalized);
+		safeModulePaths.add(normalized + "?inline");
+	}
+}
+//#endregion
+export { markStylePathSafe };
+
+//# sourceMappingURL=safe-module-paths.js.map

package/src/lib/utils/safe-module-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-module-paths.js","names":[],"sources":["../../../../src/lib/utils/safe-module-paths.ts"],"sourcesContent":["import { normalizePath, type ResolvedConfig } from 'vite';\n\n/**\n * Mark a style file path as safe in Vite's `safeModulePaths` set so the\n * `?inline` import passes the Denied ID security check without needing\n * the plugin to intercept the load.\n *\n * Vite's own import-analysis transform does the same thing (adds the clean\n * URL to `safeModulePaths` during transform). We additionally add the\n * `?inline` form because `isServerAccessDeniedForTransform` checks *both*\n * `cleanUrl(id)` and the full `id` (with query) against the allow list.\n *\n * This lets `?inline` CSS flow through Vite's native CSS pipeline, which\n * handles preprocessing, `test.css` semantics, and browser-vs-node\n * differences without the plugin having to reimplement any of it.\n */\nexport function markStylePathSafe(\n  config: ResolvedConfig | undefined,\n  absPath: string,\n): void {\n  if (!config) return;\n  const normalized = normalizePath(absPath);\n  const safeModulePaths = (config as any).safeModulePaths as\n    | Set<string>\n    | undefined;\n  if (safeModulePaths) {\n    safeModulePaths.add(normalized);\n    safeModulePaths.add(normalized + '?inline');\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,kBACd,QACA,SACM;AACN,KAAI,CAAC,OAAQ;CACb,MAAM,aAAa,cAAc,QAAQ;CACzC,MAAM,kBAAmB,OAAe;AAGxC,KAAI,iBAAiB;AACnB,kBAAgB,IAAI,WAAW;AAC/B,kBAAgB,IAAI,aAAa,UAAU"}

package/src/lib/utils/source-file-cache.d.ts

@@ -1,17 +1,10 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import type ts from 'typescript';
+import type ts from "typescript";
 export declare class SourceFileCache extends Map<string, ts.SourceFile> {
-    readonly persistentCachePath?: string | undefined;
-    readonly modifiedFiles: Set<string>;
-    readonly babelFileCache: Map<string, Uint8Array>;
-    readonly typeScriptFileCache: Map<string, string | Uint8Array>;
-    referencedFiles?: readonly string[];
-    constructor(persistentCachePath?: string | undefined);
-    invalidate(files: Iterable<string>): void;
+	readonly persistentCachePath?: string | undefined;
+	readonly modifiedFiles: Set<string>;
+	readonly babelFileCache: Map<string, Uint8Array>;
+	readonly typeScriptFileCache: Map<string, string | Uint8Array>;
+	referencedFiles?: readonly string[];
+	constructor(persistentCachePath?: string | undefined);
+	invalidate(files: Iterable<string>): void;
 }

package/src/lib/utils/source-file-cache.js

@@ -1,39 +1,37 @@
+import * as path$1 from "node:path";
+import { platform } from "node:os";
+import { pathToFileURL } from "node:url";
+//#region packages/vite-plugin-angular/src/lib/utils/source-file-cache.ts
 /**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import { platform } from 'node:os';
-import * as path from 'node:path';
-import { pathToFileURL } from 'node:url';
-const USING_WINDOWS = platform() === 'win32';
-const WINDOWS_SEP_REGEXP = new RegExp(`\\${path.win32.sep}`, 'g');
-export class SourceFileCache extends Map {
-    persistentCachePath;
-    modifiedFiles = new Set();
-    babelFileCache = new Map();
-    typeScriptFileCache = new Map();
-    referencedFiles;
-    constructor(persistentCachePath) {
-        super();
-        this.persistentCachePath = persistentCachePath;
-    }
-    invalidate(files) {
-        if (files !== this.modifiedFiles) {
-            this.modifiedFiles.clear();
-        }
-        for (let file of files) {
-            this.babelFileCache.delete(file);
-            this.typeScriptFileCache.delete(pathToFileURL(file).href);
-            // Normalize separators to allow matching TypeScript Host paths
-            if (USING_WINDOWS) {
-                file = file.replace(WINDOWS_SEP_REGEXP, path.posix.sep);
-            }
-            this.delete(file);
-            this.modifiedFiles.add(file);
-        }
-    }
-}
+* @license
+* Copyright Google LLC All Rights Reserved.
+*
+* Use of this source code is governed by an MIT-style license that can be
+* found in the LICENSE file at https://angular.io/license
+*/
+var USING_WINDOWS = platform() === "win32";
+var WINDOWS_SEP_REGEXP = new RegExp(`\\${path$1.win32.sep}`, "g");
+var SourceFileCache = class extends Map {
+	modifiedFiles = /* @__PURE__ */ new Set();
+	babelFileCache = /* @__PURE__ */ new Map();
+	typeScriptFileCache = /* @__PURE__ */ new Map();
+	referencedFiles;
+	constructor(persistentCachePath) {
+		super();
+		this.persistentCachePath = persistentCachePath;
+	}
+	invalidate(files) {
+		if (files !== this.modifiedFiles) this.modifiedFiles.clear();
+		for (let file of files) {
+			this.babelFileCache.delete(file);
+			this.typeScriptFileCache.delete(pathToFileURL(file).href);
+			if (USING_WINDOWS) file = file.replace(WINDOWS_SEP_REGEXP, path$1.posix.sep);
+			this.delete(file);
+			this.modifiedFiles.add(file);
+		}
+	}
+};
+//#endregion
+export { SourceFileCache };
+
 //# sourceMappingURL=source-file-cache.js.map

package/src/lib/utils/source-file-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-file-cache.js","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-angular/src/lib/utils/source-file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,aAAa,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC;AAC7C,MAAM,kBAAkB,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;AAElE,MAAM,OAAO,eAAgB,SAAQ,GAA0B;IAaxC;IAZZ,aAAa,GAAgB,IAAI,GAAG,EAAU,CAAC;IAC/C,cAAc,GAA4B,IAAI,GAAG,EAGvD,CAAC;IACK,mBAAmB,GAAqC,IAAI,GAAG,EAGrE,CAAC;IAEJ,eAAe,CAAqB;IAEpC,YAAqB,mBAA4B;QAC/C,KAAK,EAAE,CAAC;QADW,wBAAmB,GAAnB,mBAAmB,CAAS;IAEjD,CAAC;IAED,UAAU,CAAC,KAAuB;QAChC,IAAI,KAAK,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAE1D,+DAA+D;YAC/D,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"source-file-cache.js","names":[],"sources":["../../../../src/lib/utils/source-file-cache.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.io/license\n */\n\nimport { platform } from 'node:os';\nimport * as path from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type ts from 'typescript';\n\nconst USING_WINDOWS = platform() === 'win32';\nconst WINDOWS_SEP_REGEXP = new RegExp(`\\\\${path.win32.sep}`, 'g');\n\nexport class SourceFileCache extends Map<string, ts.SourceFile> {\n  readonly modifiedFiles: Set<string> = new Set<string>();\n  readonly babelFileCache: Map<string, Uint8Array> = new Map<\n    string,\n    Uint8Array\n  >();\n  readonly typeScriptFileCache: Map<string, string | Uint8Array> = new Map<\n    string,\n    string | Uint8Array\n  >();\n\n  referencedFiles?: readonly string[];\n\n  constructor(readonly persistentCachePath?: string) {\n    super();\n  }\n\n  invalidate(files: Iterable<string>): void {\n    if (files !== this.modifiedFiles) {\n      this.modifiedFiles.clear();\n    }\n    for (let file of files) {\n      this.babelFileCache.delete(file);\n      this.typeScriptFileCache.delete(pathToFileURL(file).href);\n\n      // Normalize separators to allow matching TypeScript Host paths\n      if (USING_WINDOWS) {\n        file = file.replace(WINDOWS_SEP_REGEXP, path.posix.sep);\n      }\n\n      this.delete(file);\n      this.modifiedFiles.add(file);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAM,gBAAgB,UAAU,KAAK;AACrC,IAAM,qBAAqB,IAAI,OAAO,KAAK,OAAK,MAAM,OAAO,IAAI;AAEjE,IAAa,kBAAb,cAAqC,IAA2B;CAC9D,gCAAsC,IAAI,KAAa;CACvD,iCAAmD,IAAI,KAGpD;CACH,sCAAiE,IAAI,KAGlE;CAEH;CAEA,YAAY,qBAAuC;AACjD,SAAO;AADY,OAAA,sBAAA;;CAIrB,WAAW,OAA+B;AACxC,MAAI,UAAU,KAAK,cACjB,MAAK,cAAc,OAAO;AAE5B,OAAK,IAAI,QAAQ,OAAO;AACtB,QAAK,eAAe,OAAO,KAAK;AAChC,QAAK,oBAAoB,OAAO,cAAc,KAAK,CAAC,KAAK;AAGzD,OAAI,cACF,QAAO,KAAK,QAAQ,oBAAoB,OAAK,MAAM,IAAI;AAGzD,QAAK,OAAO,KAAK;AACjB,QAAK,cAAc,IAAI,KAAK"}

package/src/lib/utils/tailwind-reference.d.ts

@@ -0,0 +1,12 @@
+export interface CssTailwindDirectiveState {
+	commentlessCode: string;
+	hasReferenceDirective: boolean;
+	hasReferenceText: boolean;
+	hasTailwindImportDirective: boolean;
+}
+export declare class TailwindReferenceError extends Error {
+	readonly name = "TailwindReferenceError";
+}
+export declare function inspectCssTailwindDirectives(code: string): CssTailwindDirectiveState;
+export declare function throwTailwindReferenceTextError(filename: string, rootStylesheet: string): never;
+export declare function isTailwindReferenceError(error: unknown): error is TailwindReferenceError;

package/src/lib/utils/tailwind-reference.js

@@ -0,0 +1,99 @@
+//#region packages/vite-plugin-angular/src/lib/utils/tailwind-reference.ts
+var ANGULAR_TAILWIND_PREFIX = "[@analogjs/vite-plugin-angular]";
+var CSS_REFERENCE_DIRECTIVE_REGEX = /(^|[;}\n\r])\s*@reference\b/m;
+var CSS_TAILWIND_IMPORT_REGEX = /(^|[;}\n\r])\s*@import\s+["']tailwindcss["']/m;
+var TailwindReferenceError = class extends Error {
+	name = "TailwindReferenceError";
+};
+function stripCssBlockComments(code) {
+	let result = "";
+	let quote = null;
+	for (let index = 0; index < code.length; index++) {
+		const character = code[index];
+		const nextCharacter = code[index + 1];
+		if (quote) {
+			if (character === "\\" && nextCharacter) {
+				result += character;
+				result += nextCharacter;
+				index++;
+				continue;
+			}
+			if (character === quote) quote = null;
+			result += character;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") {
+			quote = character;
+			result += character;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "*") {
+			result += "  ";
+			index += 2;
+			while (index < code.length) {
+				const commentCharacter = code[index];
+				const commentNextCharacter = code[index + 1];
+				if (commentCharacter === "*" && commentNextCharacter === "/") {
+					result += "  ";
+					index++;
+					break;
+				}
+				result += commentCharacter === "\n" || commentCharacter === "\r" ? commentCharacter : " ";
+				index++;
+			}
+			continue;
+		}
+		result += character;
+	}
+	return result;
+}
+function hasReferenceTextInComments(code) {
+	let quote = null;
+	for (let index = 0; index < code.length; index++) {
+		const character = code[index];
+		const nextCharacter = code[index + 1];
+		if (quote) {
+			if (character === "\\" && nextCharacter) {
+				index++;
+				continue;
+			}
+			if (character === quote) quote = null;
+			continue;
+		}
+		if (character === "\"" || character === "'" || character === "`") {
+			quote = character;
+			continue;
+		}
+		if (character === "/" && nextCharacter === "*") {
+			const commentStart = index + 2;
+			index += 2;
+			while (index < code.length) {
+				const commentCharacter = code[index];
+				const commentNextCharacter = code[index + 1];
+				if (commentCharacter === "*" && commentNextCharacter === "/") break;
+				index++;
+			}
+			if (code.slice(commentStart, index).includes("@reference")) return true;
+		}
+	}
+	return false;
+}
+function inspectCssTailwindDirectives(code) {
+	const commentlessCode = stripCssBlockComments(code);
+	return {
+		commentlessCode,
+		hasReferenceDirective: CSS_REFERENCE_DIRECTIVE_REGEX.test(commentlessCode),
+		hasReferenceText: hasReferenceTextInComments(code),
+		hasTailwindImportDirective: CSS_TAILWIND_IMPORT_REGEX.test(commentlessCode)
+	};
+}
+function throwTailwindReferenceTextError(filename, rootStylesheet) {
+	throw new TailwindReferenceError(`${ANGULAR_TAILWIND_PREFIX} Tailwind @reference auto-injection was blocked for "${filename}" because the stylesheet contains the text "@reference" but does not contain a real @reference directive.\n\nThis is usually caused by a CSS comment such as "/* ... @reference ... */".\n\nFix one of:\n  - Reword the comment so it does not contain "@reference"\n  - Add a real @reference "${rootStylesheet}"; directive\n`);
+}
+function isTailwindReferenceError(error) {
+	return error instanceof TailwindReferenceError;
+}
+//#endregion
+export { inspectCssTailwindDirectives, isTailwindReferenceError, throwTailwindReferenceTextError };
+
+//# sourceMappingURL=tailwind-reference.js.map

package/src/lib/utils/tailwind-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-reference.js","names":[],"sources":["../../../../src/lib/utils/tailwind-reference.ts"],"sourcesContent":["const ANGULAR_TAILWIND_PREFIX = '[@analogjs/vite-plugin-angular]';\nconst CSS_REFERENCE_DIRECTIVE_REGEX = /(^|[;}\\n\\r])\\s*@reference\\b/m;\nconst CSS_TAILWIND_IMPORT_REGEX =\n  /(^|[;}\\n\\r])\\s*@import\\s+[\"']tailwindcss[\"']/m;\n\nexport interface CssTailwindDirectiveState {\n  commentlessCode: string;\n  hasReferenceDirective: boolean;\n  hasReferenceText: boolean;\n  hasTailwindImportDirective: boolean;\n}\n\nexport class TailwindReferenceError extends Error {\n  readonly name = 'TailwindReferenceError';\n}\n\n// Match real CSS directives, not prose inside block comments. The scanner keeps\n// quoted CSS content intact so `/* ... */` sequences inside strings do not get\n// mistaken for real comments.\nfunction stripCssBlockComments(code: string): string {\n  let result = '';\n  let quote: '\"' | \"'\" | '`' | null = null;\n\n  for (let index = 0; index < code.length; index++) {\n    const character = code[index];\n    const nextCharacter = code[index + 1];\n\n    if (quote) {\n      if (character === '\\\\' && nextCharacter) {\n        result += character;\n        result += nextCharacter;\n        index++;\n        continue;\n      }\n      if (character === quote) {\n        quote = null;\n      }\n      result += character;\n      continue;\n    }\n\n    if (character === '\"' || character === \"'\" || character === '`') {\n      quote = character;\n      result += character;\n      continue;\n    }\n\n    if (character === '/' && nextCharacter === '*') {\n      result += '  ';\n      index += 2;\n\n      while (index < code.length) {\n        const commentCharacter = code[index];\n        const commentNextCharacter = code[index + 1];\n\n        if (commentCharacter === '*' && commentNextCharacter === '/') {\n          result += '  ';\n          index++;\n          break;\n        }\n\n        result +=\n          commentCharacter === '\\n' || commentCharacter === '\\r'\n            ? commentCharacter\n            : ' ';\n        index++;\n      }\n      continue;\n    }\n\n    result += character;\n  }\n\n  return result;\n}\n\nfunction hasReferenceTextInComments(code: string): boolean {\n  let quote: '\"' | \"'\" | '`' | null = null;\n\n  for (let index = 0; index < code.length; index++) {\n    const character = code[index];\n    const nextCharacter = code[index + 1];\n\n    if (quote) {\n      if (character === '\\\\' && nextCharacter) {\n        index++;\n        continue;\n      }\n      if (character === quote) {\n        quote = null;\n      }\n      continue;\n    }\n\n    if (character === '\"' || character === \"'\" || character === '`') {\n      quote = character;\n      continue;\n    }\n\n    if (character === '/' && nextCharacter === '*') {\n      const commentStart = index + 2;\n      index += 2;\n\n      while (index < code.length) {\n        const commentCharacter = code[index];\n        const commentNextCharacter = code[index + 1];\n\n        if (commentCharacter === '*' && commentNextCharacter === '/') {\n          break;\n        }\n        index++;\n      }\n\n      if (code.slice(commentStart, index).includes('@reference')) {\n        return true;\n      }\n    }\n  }\n\n  return false;\n}\n\nexport function inspectCssTailwindDirectives(\n  code: string,\n): CssTailwindDirectiveState {\n  const commentlessCode = stripCssBlockComments(code);\n\n  return {\n    commentlessCode,\n    hasReferenceDirective: CSS_REFERENCE_DIRECTIVE_REGEX.test(commentlessCode),\n    hasReferenceText: hasReferenceTextInComments(code),\n    hasTailwindImportDirective: CSS_TAILWIND_IMPORT_REGEX.test(commentlessCode),\n  };\n}\n\nexport function throwTailwindReferenceTextError(\n  filename: string,\n  rootStylesheet: string,\n): never {\n  throw new TailwindReferenceError(\n    `${ANGULAR_TAILWIND_PREFIX} Tailwind @reference auto-injection was ` +\n      `blocked for \"${filename}\" because the stylesheet contains the ` +\n      `text \"@reference\" but does not contain a real @reference ` +\n      `directive.\\n\\n` +\n      `This is usually caused by a CSS comment such as ` +\n      `\"/* ... @reference ... */\".\\n\\n` +\n      `Fix one of:\\n` +\n      `  - Reword the comment so it does not contain \"@reference\"\\n` +\n      `  - Add a real @reference \"${rootStylesheet}\"; directive\\n`,\n  );\n}\n\nexport function isTailwindReferenceError(\n  error: unknown,\n): error is TailwindReferenceError {\n  return error instanceof TailwindReferenceError;\n}\n"],"mappings":";AAAA,IAAM,0BAA0B;AAChC,IAAM,gCAAgC;AACtC,IAAM,4BACJ;AASF,IAAa,yBAAb,cAA4C,MAAM;CAChD,OAAgB;;AAMlB,SAAS,sBAAsB,MAAsB;CACnD,IAAI,SAAS;CACb,IAAI,QAAgC;AAEpC,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;EAChD,MAAM,YAAY,KAAK;EACvB,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,MAAI,OAAO;AACT,OAAI,cAAc,QAAQ,eAAe;AACvC,cAAU;AACV,cAAU;AACV;AACA;;AAEF,OAAI,cAAc,MAChB,SAAQ;AAEV,aAAU;AACV;;AAGF,MAAI,cAAc,QAAO,cAAc,OAAO,cAAc,KAAK;AAC/D,WAAQ;AACR,aAAU;AACV;;AAGF,MAAI,cAAc,OAAO,kBAAkB,KAAK;AAC9C,aAAU;AACV,YAAS;AAET,UAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,mBAAmB,KAAK;IAC9B,MAAM,uBAAuB,KAAK,QAAQ;AAE1C,QAAI,qBAAqB,OAAO,yBAAyB,KAAK;AAC5D,eAAU;AACV;AACA;;AAGF,cACE,qBAAqB,QAAQ,qBAAqB,OAC9C,mBACA;AACN;;AAEF;;AAGF,YAAU;;AAGZ,QAAO;;AAGT,SAAS,2BAA2B,MAAuB;CACzD,IAAI,QAAgC;AAEpC,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;EAChD,MAAM,YAAY,KAAK;EACvB,MAAM,gBAAgB,KAAK,QAAQ;AAEnC,MAAI,OAAO;AACT,OAAI,cAAc,QAAQ,eAAe;AACvC;AACA;;AAEF,OAAI,cAAc,MAChB,SAAQ;AAEV;;AAGF,MAAI,cAAc,QAAO,cAAc,OAAO,cAAc,KAAK;AAC/D,WAAQ;AACR;;AAGF,MAAI,cAAc,OAAO,kBAAkB,KAAK;GAC9C,MAAM,eAAe,QAAQ;AAC7B,YAAS;AAET,UAAO,QAAQ,KAAK,QAAQ;IAC1B,MAAM,mBAAmB,KAAK;IAC9B,MAAM,uBAAuB,KAAK,QAAQ;AAE1C,QAAI,qBAAqB,OAAO,yBAAyB,IACvD;AAEF;;AAGF,OAAI,KAAK,MAAM,cAAc,MAAM,CAAC,SAAS,aAAa,CACxD,QAAO;;;AAKb,QAAO;;AAGT,SAAgB,6BACd,MAC2B;CAC3B,MAAM,kBAAkB,sBAAsB,KAAK;AAEnD,QAAO;EACL;EACA,uBAAuB,8BAA8B,KAAK,gBAAgB;EAC1E,kBAAkB,2BAA2B,KAAK;EAClD,4BAA4B,0BAA0B,KAAK,gBAAgB;EAC5E;;AAGH,SAAgB,gCACd,UACA,gBACO;AACP,OAAM,IAAI,uBACR,GAAG,wBAAwB,uDACT,SAAS,kSAOK,eAAe,gBAChD;;AAGH,SAAgB,yBACd,OACiC;AACjC,QAAO,iBAAiB"}

package/src/lib/utils/transform-cache.d.ts

@@ -0,0 +1,43 @@
+/**
+* The `{ get, put }` shape `@angular/build`'s `JavaScriptTransformer`
+* accepts as its third constructor argument. Keys are SHA-256 digests the
+* transformer derives from the file bytes plus every option that affects
+* output, so entries are immutable and never need invalidation — but the
+* digest does NOT cover the linker version, so stores must be namespaced
+* by Angular version (see {@link resolveTransformCacheDir}).
+*/
+export interface TransformCacheStore {
+	get(key: string): Promise<Uint8Array | undefined> | Uint8Array | undefined;
+	put(key: string, value: Uint8Array): Promise<void> | void;
+}
+interface TransformCacheStats {
+	hits: number;
+	misses: number;
+	writes: number;
+	/** Approximate total ms spent in the linker worker for cache misses. */
+	workerMs: number;
+}
+/**
+* Disk-backed content-addressed store for linked/transformed dependency
+* output. Entries are written atomically (temp + rename) so concurrent
+* dev servers can share a directory; all failures degrade to a miss.
+*/
+export declare function createPersistentTransformCache(baseDir: string): TransformCacheStore & {
+	stats: TransformCacheStats;
+};
+/**
+* Layer an unbounded in-memory map over a persistent store so repeat
+* transforms in the same session never touch the disk.
+*/
+export declare function withMemoryLayer(store: TransformCacheStore): TransformCacheStore;
+/**
+* Resolve the shared on-disk cache directory: `node_modules/.cache` at the
+* nearest `node_modules` above `startDir` — the conventional tool-cache
+* location, so installs and `node_modules` cleans evict it without a
+* separate eviction pass. Namespaced by the installed Angular version
+* because the transformer's cache key does not cover the linker version.
+* Returns `null` (caching disabled) when no `node_modules` exists or the
+* `ANALOG_TRANSFORM_CACHE=0` kill switch is set.
+*/
+export declare function resolveTransformCacheDir(startDir: string): string | null;
+export {};