@analogjs/vite-plugin-angular 2.5.0-beta.41 → 2.5.0-beta.43

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

@@ -0,0 +1,213 @@
+/**
+ * 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 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;
+    // Build assignment statements
+    const assignments = fieldsToLower.map((f) => `    this${f.accessor} = ${f.initializer};`);
+    // Find existing constructor
+    const ctor = members.find((m) => m.type === 'MethodDefinition' && m.kind === 'constructor');
+    // Check if class has a superclass
+    const hasSuperClass = !!classNode.superClass;
+    if (ctor) {
+        insertIntoExistingConstructor(ms, sourceCode, ctor, assignments);
+    }
+    else {
+        createConstructorWithAssignments(ms, sourceCode, body, members, assignments, hasSuperClass);
+    }
+    // Remove or strip field declarations
+    for (const field of fieldsToLower) {
+        if (field.isPrivate) {
+            // Keep declaration without initializer: `#field;`
+            // Start scanning after the type annotation (if present) to avoid
+            // matching `=` inside `=>` of arrow function type annotations.
+            const scanFrom = field.node.typeAnnotation
+                ? field.node.typeAnnotation.end
+                : field.node.key.end;
+            const eqStart = findEqualsSign(sourceCode, scanFrom, field.node.value.start);
+            ms.remove(eqStart, field.node.value.end);
+        }
+        else {
+            // Remove the field declaration. Include the trailing newline to avoid
+            // leaving blank lines, BUT only if the character after the newline isn't
+            // the closing `}` of the class. Otherwise the removal range ends at the
+            // same position where Ivy static definitions are appendLeft-inserted,
+            // and MagicString consumes those insertions as part of the removed range.
+            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;
+            // Only consume newline(s) when the next non-whitespace char is not `}`
+            const safeToConsumeNewline = charAfterNewline !== null && charAfterNewline !== '}';
+            if (safeToConsumeNewline) {
+                if (nextChar === '\n')
+                    end++;
+                else if (nextChar === '\r' && sourceCode[end + 1] === '\n')
+                    end += 2;
+            }
+            ms.remove(field.node.start, end);
+        }
+    }
+}
+function shouldLowerField(member) {
+    // Must be a PropertyDefinition with an initializer (value)
+    if (member.type !== 'PropertyDefinition')
+        return false;
+    if (!member.value)
+        return false;
+    // Don't lower static fields
+    if (member.static)
+        return false;
+    // Don't lower declare fields
+    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;
+    }
+    // Computed key: `[expr] = value` → `this[expr] = value`
+    // OXC marks the parent PropertyDefinition with `computed: true`.
+    if (member.computed) {
+        return '[' + sourceCode.slice(key.start, key.end) + ']';
+    }
+    if (key.type === 'Identifier') {
+        return '.' + key.name;
+    }
+    // String literal key: `'some-key' = value` → `this['some-key'] = value`
+    if (key.type === 'StringLiteral' ||
+        (key.type === 'Literal' && typeof key.value === 'string')) {
+        return '[' + JSON.stringify(key.value) + ']';
+    }
+    // Numeric literal key: `123 = value` → `this[123] = value`
+    if (key.type === 'NumericLiteral' ||
+        (key.type === 'Literal' && typeof key.value === 'number')) {
+        return '[' + key.value + ']';
+    }
+    // Fallback: bracket-access with the original source text
+    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');
+    // Find the position after super() call (if any)
+    let insertPos = null;
+    for (const stmt of bodyStatements) {
+        if (isSuperCall(stmt)) {
+            // Insert after super() statement including its semicolon
+            insertPos = stmt.end;
+            break;
+        }
+    }
+    if (insertPos !== null) {
+        ms.appendRight(insertPos, assignmentBlock);
+    }
+    else if (bodyStatements.length > 0) {
+        // Insert before the first statement
+        ms.appendRight(bodyStatements[0].start, assignments.join('\n') + '\n    ');
+    }
+    else {
+        // Empty constructor body — insert after opening {
+        ms.appendRight(ctorBody.start + 1, assignmentBlock + '\n  ');
+    }
+}
+function createConstructorWithAssignments(ms, sourceCode, classBody, members, assignments, hasSuperClass) {
+    const superCall = hasSuperClass ? '    super(...args);\n' : '';
+    const args = hasSuperClass ? '...args' : '';
+    const ctorCode = [
+        `  constructor(${args}) {`,
+        superCall ? superCall.trimEnd() : null,
+        ...assignments,
+        '  }',
+    ]
+        .filter((l) => l !== null)
+        .join('\n');
+    // Insert constructor at the beginning of the class body (after opening {)
+    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';
+}
+//# 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","sourceRoot":"","sources":["../../../../../../packages/vite-plugin-angular/src/lib/compiler/class-field-lowering.ts"],"names":[],"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;