@analogjs/vite-plugin-angular 3.0.0-alpha.36 → 3.0.0-alpha.38

package/src/lib/compiler/angular-version.d.ts

@@ -0,0 +1,19 @@
+/**
+* The major version of the installed `@angular/compiler` package, parsed
+* from `o.VERSION.major`. Falls back to `DEFAULT_ASSUMED_MAJOR` when the
+* version is unavailable.
+*/
+export declare const ANGULAR_MAJOR: number;
+/**
+* Returns `true` when the installed Angular major is at least `major`.
+* Use this to gate code paths that depend on APIs introduced in a
+* specific Angular release.
+*
+* @example
+*   if (angularVersionAtLeast(21)) {
+*     // Use Angular 21+ API
+*   } else {
+*     // Fall back to v19/v20 behavior
+*   }
+*/
+export declare function angularVersionAtLeast(major: number): boolean;

package/src/lib/compiler/angular-version.js

@@ -0,0 +1,16 @@
+import * as o from "@angular/compiler";
+//#region packages/vite-plugin-angular/src/lib/compiler/angular-version.ts
+var DEFAULT_ASSUMED_MAJOR = 22;
+/**
+* The major version of the installed `@angular/compiler` package, parsed
+* from `o.VERSION.major`. Falls back to `DEFAULT_ASSUMED_MAJOR` when the
+* version is unavailable.
+*/
+var ANGULAR_MAJOR = (() => {
+	const major = Number.parseInt(o.VERSION?.major ?? "", 10);
+	return Number.isFinite(major) && major > 0 ? major : DEFAULT_ASSUMED_MAJOR;
+})();
+//#endregion
+export { ANGULAR_MAJOR };
+
+//# sourceMappingURL=angular-version.js.map

package/src/lib/compiler/angular-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-version.js","names":[],"sources":["../../../../src/lib/compiler/angular-version.ts"],"sourcesContent":["import * as o from '@angular/compiler';\n\n// Detect the installed @angular/compiler major version once at module load\n// time and expose helpers for version-aware code paths.\n//\n// Why this matters: Angular's compiler API surface (enum members,\n// metadata shapes, output formats) shifts between major versions in ways\n// that can't always be papered over with duck typing. The compatibility\n// matrix in .github/workflows/compiler-compat.yml runs the test\n// suite against multiple installed versions to catch this drift, and the\n// version-aware code paths in compile.ts / js-emitter.ts / metadata.ts\n// gate behavior on `ANGULAR_MAJOR` to keep the compiler working across\n// the supported `peerDependencies` range (currently >=19.0.0).\n//\n// Default fallback: when the version string is missing or unparseable\n// (vendored builds, monkey-patched test environments), assume the latest\n// known major. This biases toward the most-tested code path.\nconst DEFAULT_ASSUMED_MAJOR = 22;\n\n/**\n * The major version of the installed `@angular/compiler` package, parsed\n * from `o.VERSION.major`. Falls back to `DEFAULT_ASSUMED_MAJOR` when the\n * version is unavailable.\n */\nexport const ANGULAR_MAJOR: number = (() => {\n  const major = Number.parseInt(o.VERSION?.major ?? '', 10);\n  return Number.isFinite(major) && major > 0 ? major : DEFAULT_ASSUMED_MAJOR;\n})();\n\n/**\n * Returns `true` when the installed Angular major is at least `major`.\n * Use this to gate code paths that depend on APIs introduced in a\n * specific Angular release.\n *\n * @example\n *   if (angularVersionAtLeast(21)) {\n *     // Use Angular 21+ API\n *   } else {\n *     // Fall back to v19/v20 behavior\n *   }\n */\nexport function angularVersionAtLeast(major: number): boolean {\n  return ANGULAR_MAJOR >= major;\n}\n"],"mappings":";;AAiBA,IAAM,wBAAwB;;;;;;AAO9B,IAAa,uBAA+B;CAC1C,MAAM,QAAQ,OAAO,SAAS,EAAE,SAAS,SAAS,IAAI,GAAG;AACzD,QAAO,OAAO,SAAS,MAAM,IAAI,QAAQ,IAAI,QAAQ;IACnD"}

package/src/lib/compiler/class-field-lowering.d.ts

@@ -0,0 +1,23 @@
+import MagicString from "magic-string";
+/**
+* Lower instance class field initializers into constructor assignments.
+*
+* When `useDefineForClassFields` is `false` (the standard Angular tsconfig),
+* field initializers must run as assignments inside the constructor body
+* rather than as native ES class field initializers. This ensures:
+*
+* 1. `inject()` calls in fields have an active injection context
+* 2. Fields referencing other injected fields work (sequential assignment)
+* 3. Constructor parameter properties are available to field initializers
+* 4. Inheritance works (parent constructor runs before child field assignments)
+*
+* Rules:
+* - Regular fields with initializers: remove declaration, add `this.field = value;`
+* - Private fields (`#field`) with initializers: keep `#field;` declaration, add `this.#field = value;`
+* - Static fields: not lowered
+* - Fields without initializers: not lowered
+* - `declare` fields: not lowered
+* - Assignments are inserted after `super()` (if present), before existing constructor body
+* - If no constructor exists, one is created (with `super(...args)` for subclasses)
+*/
+export declare function lowerClassFields(ms: MagicString, sourceCode: string, oxcProgram: any): void;

package/src/lib/compiler/class-field-lowering.js

@@ -0,0 +1,131 @@
+//#region packages/vite-plugin-angular/src/lib/compiler/class-field-lowering.ts
+/**
+* Lower instance class field initializers into constructor assignments.
+*
+* When `useDefineForClassFields` is `false` (the standard Angular tsconfig),
+* field initializers must run as assignments inside the constructor body
+* rather than as native ES class field initializers. This ensures:
+*
+* 1. `inject()` calls in fields have an active injection context
+* 2. Fields referencing other injected fields work (sequential assignment)
+* 3. Constructor parameter properties are available to field initializers
+* 4. Inheritance works (parent constructor runs before child field assignments)
+*
+* Rules:
+* - Regular fields with initializers: remove declaration, add `this.field = value;`
+* - Private fields (`#field`) with initializers: keep `#field;` declaration, add `this.#field = value;`
+* - Static fields: not lowered
+* - Fields without initializers: not lowered
+* - `declare` fields: not lowered
+* - Assignments are inserted after `super()` (if present), before existing constructor body
+* - If no constructor exists, one is created (with `super(...args)` for subclasses)
+*/
+function lowerClassFields(ms, sourceCode, oxcProgram) {
+	for (const stmt of oxcProgram.body) {
+		const decl = stmt.type === "ExportNamedDeclaration" || stmt.type === "ExportDefaultDeclaration" ? stmt.declaration : stmt;
+		if (!decl || decl.type !== "ClassDeclaration" && decl.type !== "ClassExpression" || !decl.body) continue;
+		lowerClassFieldsForClass(ms, sourceCode, decl);
+	}
+}
+function lowerClassFieldsForClass(ms, sourceCode, classNode) {
+	const body = classNode.body;
+	const members = body.body;
+	const fieldsToLower = [];
+	for (const member of members) {
+		if (!shouldLowerField(member)) continue;
+		const accessor = getFieldAccessor(member, sourceCode);
+		const initializer = sourceCode.slice(member.value.start, member.value.end);
+		fieldsToLower.push({
+			node: member,
+			accessor,
+			initializer,
+			isPrivate: member.type === "PropertyDefinition" && member.key?.type === "PrivateIdentifier"
+		});
+	}
+	if (fieldsToLower.length === 0) return;
+	const assignments = fieldsToLower.map((f) => `    this${f.accessor} = ${f.initializer};`);
+	const ctor = members.find((m) => m.type === "MethodDefinition" && m.kind === "constructor");
+	const hasSuperClass = !!classNode.superClass;
+	if (ctor) insertIntoExistingConstructor(ms, sourceCode, ctor, assignments);
+	else createConstructorWithAssignments(ms, sourceCode, body, members, assignments, hasSuperClass);
+	for (const field of fieldsToLower) if (field.isPrivate) {
+		const eqStart = findEqualsSign(sourceCode, field.node.typeAnnotation ? field.node.typeAnnotation.end : field.node.key.end, field.node.value.start);
+		ms.remove(eqStart, field.node.value.end);
+	} else {
+		let end = field.node.end;
+		const nextChar = sourceCode[end];
+		const charAfterNewline = nextChar === "\n" ? sourceCode[end + 1] : nextChar === "\r" && sourceCode[end + 1] === "\n" ? sourceCode[end + 2] : null;
+		if (charAfterNewline !== null && charAfterNewline !== "}") {
+			if (nextChar === "\n") end++;
+			else if (nextChar === "\r" && sourceCode[end + 1] === "\n") end += 2;
+		}
+		ms.remove(field.node.start, end);
+	}
+}
+function shouldLowerField(member) {
+	if (member.type !== "PropertyDefinition") return false;
+	if (!member.value) return false;
+	if (member.static) return false;
+	if (member.declare) return false;
+	return true;
+}
+/**
+* Build the member-access expression to append after `this` for a class field
+* being lowered. Returns the accessor with its leading punctuation:
+*
+* - `.name`         — non-computed identifier key
+* - `.#priv`        — private identifier key
+* - `[expr]`        — computed key (square brackets in source)
+* - `['some-key']`  — string literal key
+* - `[123]`         — numeric literal key
+*
+* Without this, fields with non-identifier keys produced invalid syntax like
+* `this.'some-key' = …` which OXC parses as "Cannot assign to this expression".
+*/
+function getFieldAccessor(member, sourceCode) {
+	const key = member.key;
+	if (key.type === "PrivateIdentifier") return ".#" + key.name;
+	if (member.computed) return "[" + sourceCode.slice(key.start, key.end) + "]";
+	if (key.type === "Identifier") return "." + key.name;
+	if (key.type === "StringLiteral" || key.type === "Literal" && typeof key.value === "string") return "[" + JSON.stringify(key.value) + "]";
+	if (key.type === "NumericLiteral" || key.type === "Literal" && typeof key.value === "number") return "[" + key.value + "]";
+	return "[" + sourceCode.slice(key.start, key.end) + "]";
+}
+function findEqualsSign(sourceCode, from, to) {
+	for (let i = from; i < to; i++) if (sourceCode[i] === "=") return i;
+	return from;
+}
+function insertIntoExistingConstructor(ms, sourceCode, ctor, assignments) {
+	const ctorBody = ctor.value.body;
+	if (!ctorBody) return;
+	const bodyStatements = ctorBody.body;
+	const assignmentBlock = "\n" + assignments.join("\n");
+	let insertPos = null;
+	for (const stmt of bodyStatements) if (isSuperCall(stmt)) {
+		insertPos = stmt.end;
+		break;
+	}
+	if (insertPos !== null) ms.appendRight(insertPos, assignmentBlock);
+	else if (bodyStatements.length > 0) ms.appendRight(bodyStatements[0].start, assignments.join("\n") + "\n    ");
+	else ms.appendRight(ctorBody.start + 1, assignmentBlock + "\n  ");
+}
+function createConstructorWithAssignments(ms, sourceCode, classBody, members, assignments, hasSuperClass) {
+	const superCall = hasSuperClass ? "    super(...args);\n" : "";
+	const ctorCode = [
+		`  constructor(${hasSuperClass ? "...args" : ""}) {`,
+		superCall ? superCall.trimEnd() : null,
+		...assignments,
+		"  }"
+	].filter((l) => l !== null).join("\n");
+	ms.appendRight(classBody.start + 1, "\n" + ctorCode + "\n");
+}
+function isSuperCall(stmt) {
+	if (stmt.type !== "ExpressionStatement") return false;
+	const expr = stmt.expression;
+	if (expr.type !== "CallExpression") return false;
+	return expr.callee?.type === "Super";
+}
+//#endregion
+export { lowerClassFields };
+
+//# sourceMappingURL=class-field-lowering.js.map

package/src/lib/compiler/class-field-lowering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-field-lowering.js","names":[],"sources":["../../../../src/lib/compiler/class-field-lowering.ts"],"sourcesContent":["import MagicString from 'magic-string';\n\n/**\n * Lower instance class field initializers into constructor assignments.\n *\n * When `useDefineForClassFields` is `false` (the standard Angular tsconfig),\n * field initializers must run as assignments inside the constructor body\n * rather than as native ES class field initializers. This ensures:\n *\n * 1. `inject()` calls in fields have an active injection context\n * 2. Fields referencing other injected fields work (sequential assignment)\n * 3. Constructor parameter properties are available to field initializers\n * 4. Inheritance works (parent constructor runs before child field assignments)\n *\n * Rules:\n * - Regular fields with initializers: remove declaration, add `this.field = value;`\n * - Private fields (`#field`) with initializers: keep `#field;` declaration, add `this.#field = value;`\n * - Static fields: not lowered\n * - Fields without initializers: not lowered\n * - `declare` fields: not lowered\n * - Assignments are inserted after `super()` (if present), before existing constructor body\n * - If no constructor exists, one is created (with `super(...args)` for subclasses)\n */\nexport function lowerClassFields(\n  ms: MagicString,\n  sourceCode: string,\n  oxcProgram: any,\n): void {\n  for (const stmt of oxcProgram.body) {\n    const decl =\n      stmt.type === 'ExportNamedDeclaration' ||\n      stmt.type === 'ExportDefaultDeclaration'\n        ? (stmt as any).declaration\n        : stmt;\n\n    if (\n      !decl ||\n      (decl.type !== 'ClassDeclaration' && decl.type !== 'ClassExpression') ||\n      !decl.body\n    ) {\n      continue;\n    }\n\n    lowerClassFieldsForClass(ms, sourceCode, decl);\n  }\n}\n\ninterface FieldToLower {\n  /** The full property definition node */\n  node: any;\n  /** The member access expression to append after `this`, e.g. `.name`, `.#priv`, `[expr]`, `['some-key']`, `[123]` */\n  accessor: string;\n  /** The initializer source text */\n  initializer: string;\n  /** Whether this is a private field (#field) */\n  isPrivate: boolean;\n}\n\nfunction lowerClassFieldsForClass(\n  ms: MagicString,\n  sourceCode: string,\n  classNode: any,\n): void {\n  const body = classNode.body;\n  const members: any[] = body.body;\n  const fieldsToLower: FieldToLower[] = [];\n\n  for (const member of members) {\n    if (!shouldLowerField(member)) continue;\n\n    const accessor = getFieldAccessor(member, sourceCode);\n    const initializer = sourceCode.slice(member.value.start, member.value.end);\n\n    fieldsToLower.push({\n      node: member,\n      accessor,\n      initializer,\n      isPrivate:\n        member.type === 'PropertyDefinition' &&\n        member.key?.type === 'PrivateIdentifier',\n    });\n  }\n\n  if (fieldsToLower.length === 0) return;\n\n  // Build assignment statements\n  const assignments = fieldsToLower.map(\n    (f) => `    this${f.accessor} = ${f.initializer};`,\n  );\n\n  // Find existing constructor\n  const ctor = members.find(\n    (m: any) => m.type === 'MethodDefinition' && m.kind === 'constructor',\n  );\n\n  // Check if class has a superclass\n  const hasSuperClass = !!classNode.superClass;\n\n  if (ctor) {\n    insertIntoExistingConstructor(ms, sourceCode, ctor, assignments);\n  } else {\n    createConstructorWithAssignments(\n      ms,\n      sourceCode,\n      body,\n      members,\n      assignments,\n      hasSuperClass,\n    );\n  }\n\n  // Remove or strip field declarations\n  for (const field of fieldsToLower) {\n    if (field.isPrivate) {\n      // Keep declaration without initializer: `#field;`\n      // Start scanning after the type annotation (if present) to avoid\n      // matching `=` inside `=>` of arrow function type annotations.\n      const scanFrom = field.node.typeAnnotation\n        ? field.node.typeAnnotation.end\n        : field.node.key.end;\n      const eqStart = findEqualsSign(\n        sourceCode,\n        scanFrom,\n        field.node.value.start,\n      );\n      ms.remove(eqStart, field.node.value.end);\n    } else {\n      // Remove the field declaration. Include the trailing newline to avoid\n      // leaving blank lines, BUT only if the character after the newline isn't\n      // the closing `}` of the class. Otherwise the removal range ends at the\n      // same position where Ivy static definitions are appendLeft-inserted,\n      // and MagicString consumes those insertions as part of the removed range.\n      let end = field.node.end;\n      const nextChar = sourceCode[end];\n      const charAfterNewline =\n        nextChar === '\\n'\n          ? sourceCode[end + 1]\n          : nextChar === '\\r' && sourceCode[end + 1] === '\\n'\n            ? sourceCode[end + 2]\n            : null;\n      // Only consume newline(s) when the next non-whitespace char is not `}`\n      const safeToConsumeNewline =\n        charAfterNewline !== null && charAfterNewline !== '}';\n      if (safeToConsumeNewline) {\n        if (nextChar === '\\n') end++;\n        else if (nextChar === '\\r' && sourceCode[end + 1] === '\\n') end += 2;\n      }\n      ms.remove(field.node.start, end);\n    }\n  }\n}\n\nfunction shouldLowerField(member: any): boolean {\n  // Must be a PropertyDefinition with an initializer (value)\n  if (member.type !== 'PropertyDefinition') return false;\n  if (!member.value) return false;\n  // Don't lower static fields\n  if (member.static) return false;\n  // Don't lower declare fields\n  if (member.declare) return false;\n\n  return true;\n}\n\n/**\n * Build the member-access expression to append after `this` for a class field\n * being lowered. Returns the accessor with its leading punctuation:\n *\n * - `.name`         — non-computed identifier key\n * - `.#priv`        — private identifier key\n * - `[expr]`        — computed key (square brackets in source)\n * - `['some-key']`  — string literal key\n * - `[123]`         — numeric literal key\n *\n * Without this, fields with non-identifier keys produced invalid syntax like\n * `this.'some-key' = …` which OXC parses as \"Cannot assign to this expression\".\n */\nfunction getFieldAccessor(member: any, sourceCode: string): string {\n  const key = member.key;\n  if (key.type === 'PrivateIdentifier') {\n    return '.#' + key.name;\n  }\n  // Computed key: `[expr] = value` → `this[expr] = value`\n  // OXC marks the parent PropertyDefinition with `computed: true`.\n  if (member.computed) {\n    return '[' + sourceCode.slice(key.start, key.end) + ']';\n  }\n  if (key.type === 'Identifier') {\n    return '.' + key.name;\n  }\n  // String literal key: `'some-key' = value` → `this['some-key'] = value`\n  if (\n    key.type === 'StringLiteral' ||\n    (key.type === 'Literal' && typeof key.value === 'string')\n  ) {\n    return '[' + JSON.stringify(key.value) + ']';\n  }\n  // Numeric literal key: `123 = value` → `this[123] = value`\n  if (\n    key.type === 'NumericLiteral' ||\n    (key.type === 'Literal' && typeof key.value === 'number')\n  ) {\n    return '[' + key.value + ']';\n  }\n  // Fallback: bracket-access with the original source text\n  return '[' + sourceCode.slice(key.start, key.end) + ']';\n}\n\nfunction findEqualsSign(sourceCode: string, from: number, to: number): number {\n  for (let i = from; i < to; i++) {\n    if (sourceCode[i] === '=') return i;\n  }\n  return from;\n}\n\nfunction insertIntoExistingConstructor(\n  ms: MagicString,\n  sourceCode: string,\n  ctor: any,\n  assignments: string[],\n): void {\n  const ctorBody = ctor.value.body;\n  if (!ctorBody) return;\n\n  const bodyStatements: any[] = ctorBody.body;\n  const assignmentBlock = '\\n' + assignments.join('\\n');\n\n  // Find the position after super() call (if any)\n  let insertPos: number | null = null;\n  for (const stmt of bodyStatements) {\n    if (isSuperCall(stmt)) {\n      // Insert after super() statement including its semicolon\n      insertPos = stmt.end;\n      break;\n    }\n  }\n\n  if (insertPos !== null) {\n    ms.appendRight(insertPos, assignmentBlock);\n  } else if (bodyStatements.length > 0) {\n    // Insert before the first statement\n    ms.appendRight(bodyStatements[0].start, assignments.join('\\n') + '\\n    ');\n  } else {\n    // Empty constructor body — insert after opening {\n    ms.appendRight(ctorBody.start + 1, assignmentBlock + '\\n  ');\n  }\n}\n\nfunction createConstructorWithAssignments(\n  ms: MagicString,\n  sourceCode: string,\n  classBody: any,\n  members: any[],\n  assignments: string[],\n  hasSuperClass: boolean,\n): void {\n  const superCall = hasSuperClass ? '    super(...args);\\n' : '';\n  const args = hasSuperClass ? '...args' : '';\n  const ctorCode = [\n    `  constructor(${args}) {`,\n    superCall ? superCall.trimEnd() : null,\n    ...assignments,\n    '  }',\n  ]\n    .filter((l) => l !== null)\n    .join('\\n');\n\n  // Insert constructor at the beginning of the class body (after opening {)\n  ms.appendRight(classBody.start + 1, '\\n' + ctorCode + '\\n');\n}\n\nfunction isSuperCall(stmt: any): boolean {\n  if (stmt.type !== 'ExpressionStatement') return false;\n  const expr = stmt.expression;\n  if (expr.type !== 'CallExpression') return false;\n  return expr.callee?.type === 'Super';\n}\n"],"mappings":"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"}

package/src/lib/compiler/compile.d.ts

@@ -0,0 +1,44 @@
+import MagicString from "magic-string";
+import { ComponentRegistry } from "./registry.js";
+/**
+* COMPLETE EXHAUSTIVE ANGULAR LITE COMPILER
+* Translates Angular Decorators + Signals to Ivy Static Definitions.
+*
+* @param registry - Optional external registry from the global analysis plugin.
+*   When provided, used to resolve component/directive selectors for template compilation.
+*/
+export interface CompileResult {
+	code: string;
+	/** Source map for the transformation */
+	map: ReturnType<MagicString["generateMap"]>;
+	/** Absolute paths of external resources (templateUrl, styleUrl) read during compilation */
+	resourceDependencies: string[];
+}
+export interface CompileOptions {
+	registry?: ComponentRegistry;
+	/** Pre-resolved style contents keyed by absolute file path (e.g. SCSS already compiled to CSS). */
+	resolvedStyles?: Map<string, string>;
+	/** Pre-processed inline styles (index in styles array → compiled CSS). */
+	resolvedInlineStyles?: Map<number, string>;
+	/**
+	* When `false` (default), instance class field initializers are lowered to
+	* constructor assignments (matching TypeScript's `useDefineForClassFields: false`
+	* behavior). This is required for Angular's `inject()` and constructor DI to
+	* work correctly with the standard Angular tsconfig.
+	*/
+	useDefineForClassFields?: boolean;
+	/** Enable legacy i18n message ID format (default: true). */
+	enableI18nLegacyMessageIdFormat?: boolean;
+	/** Normalize line endings in ICU expressions (default: true). */
+	i18nNormalizeLineEndingsInICUs?: boolean;
+	/** Use external IDs in `$localize` calls (for Closure Compiler compatibility). */
+	i18nUseExternalIds?: boolean;
+	/**
+	* Compilation output mode.
+	* - `'full'` (default): Emit final Ivy definitions (`ɵɵdefineComponent`) for application builds.
+	* - `'partial'`: Emit partial declarations (`ɵɵngDeclareComponent`) for library publishing.
+	*   Partial output is version-stable and linked at application build time.
+	*/
+	compilationMode?: "full" | "partial";
+}
+export declare function compile(sourceCode: string, fileName: string, optionsOrRegistry?: CompileOptions | ComponentRegistry): CompileResult;