angular-rust-plugins 0.3.0 → 0.5.0

package/README.md

@@ -4,6 +4,14 @@ High-performance Angular linker and compiler plugins powered by Rust. Supports *
 
 This package bundles the Angular Rust binding - no additional dependencies needed!
 
+## ✨ Features
+
+- ✅ **Standard Directives**: Full support for `*ngIf` (with `else`, `then`, `as`) and `*ngFor` (with all context variables).
+- ✅ **Template Parity**: 100% output parity with NGTSC for template instructions and `consts` array sorting.
+- ✅ **Change Detection**: Optimized listener emission for `OnPush` components.
+- ✅ **Signal Support**: Full support for modern Angular signals (`input()`, `output()`, `computed()`, etc.).
+- ✅ **Blazing Fast**: Uses the Rust-based compiler for ~3-5x faster compilation compared to standard TypeScript-based compilation.
+
 ## 🚀 Installation
 
 ```bash
@@ -277,6 +285,20 @@ Ensure your `tsconfig.json` includes:
 
 The compiler plugin includes HMR support for `.html` template files. When you modify a template, the corresponding component will be recompiled automatically.
 
+## 💡 Advanced Directive Support
+
+The compiler now achieves full feature parity with the standard Angular compiler for core structural directives:
+
+### `*ngFor` Support
+- **Full Context Access**: Support for `index`, `count`, `first`, `last`, `even`, `odd`.
+- **Performance**: Automatic optimization of context access in event listeners.
+- **Parity**: Identical `consts` array ordering through source-span sorting.
+
+### `*ngIf` Support
+- **Complex Templates**: Support for `else` and `then` templates with `TemplateRef` extraction.
+- **As Syntax**: Support for the `as` local variable binding (e.g., `*ngIf="obs$ | async as val"`).
+- **Context Isolation**: Correct variable scoping and restoration for nested conditionals.
+
 ## ⚡ Performance
 
 **2-5x faster** than TypeScript-based Angular compiler with lower memory usage.

package/{dist/binding → binding}/index.d.ts

@@ -4,10 +4,21 @@
 /* auto-generated by NAPI-RS */
 
 export declare function linkFile(sourceCode: string, filename: string): string
+export interface Diagnostic {
+  file?: string
+  message: string
+  code: number
+  start?: number
+  length?: number
+}
+export interface CompileResult {
+  code: string
+  diagnostics: Array<Diagnostic>
+}
 export declare class Compiler {
   constructor()
   compile(filename: string, content: string): string
   constructor()
-  compile(filename: string, content: string): string
+  compile(filename: string, content: string): CompileResult
   linkFile(filename: string, sourceCode: string): string
 }

package/package.json

@@ -1,66 +1,62 @@
 {
   "name": "angular-rust-plugins",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Angular plugins for bundlers (Vite, esbuild, Rolldown, Webpack, Rspack) - powered by Rust compiler",
   "author": "Truonglv4",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
     },
     "./linker": {
-      "types": "./dist/linker/index.d.ts",
-      "import": "./dist/linker/index.js",
-      "require": "./dist/linker/index.cjs"
+      "types": "./linker/index.d.ts",
+      "import": "./linker/index.js",
+      "require": "./linker/index.cjs"
     },
     "./linker/vite": {
-      "types": "./dist/linker/vite.d.ts",
-      "import": "./dist/linker/vite.js",
-      "require": "./dist/linker/vite.cjs"
+      "types": "./linker/vite.d.ts",
+      "import": "./linker/vite.js",
+      "require": "./linker/vite.cjs"
     },
     "./linker/esbuild": {
-      "types": "./dist/linker/esbuild.d.ts",
-      "import": "./dist/linker/esbuild.js",
-      "require": "./dist/linker/esbuild.cjs"
+      "types": "./linker/esbuild.d.ts",
+      "import": "./linker/esbuild.js",
+      "require": "./linker/esbuild.cjs"
     },
     "./linker/rolldown": {
-      "types": "./dist/linker/rolldown.d.ts",
-      "import": "./dist/linker/rolldown.js",
-      "require": "./dist/linker/rolldown.cjs"
+      "types": "./linker/rolldown.d.ts",
+      "import": "./linker/rolldown.js",
+      "require": "./linker/rolldown.cjs"
     },
     "./compiler": {
-      "types": "./dist/compiler/index.d.ts",
-      "import": "./dist/compiler/index.js",
-      "require": "./dist/compiler/index.cjs"
+      "types": "./compiler/index.d.ts",
+      "import": "./compiler/index.js",
+      "require": "./compiler/index.cjs"
     },
     "./compiler/vite": {
-      "types": "./dist/compiler/vite.d.ts",
-      "import": "./dist/compiler/vite.js",
-      "require": "./dist/compiler/vite.cjs"
+      "types": "./compiler/vite.d.ts",
+      "import": "./compiler/vite.js",
+      "require": "./compiler/vite.cjs"
     }
   },
   "files": [
-    "dist",
-    "README.md"
+    "binding",
+    "linker",
+    "compiler",
+    "index.js",
+    "index.cjs",
+    "index.d.ts",
+    "index.d.cts",
+    "*.map",
+    "types-*.d.ts",
+    "types-*.d.cts"
   ],
-  "scripts": {
-    "copy-binding": "rm -rf src/binding && mkdir -p src/binding && cp ../binding/index.js ../binding/index.d.ts ../binding/*.node src/binding/ 2>/dev/null || true && echo '{\"type\":\"commonjs\"}' > src/binding/package.json",
-    "copy-binding-to-dist": "mkdir -p dist/binding && cp src/binding/* dist/binding/",
-    "copy-package": "cp package.dist.json dist/package.json",
-    "copy-docs": "cp README.md dist/",
-    "build": "npm run copy-binding && tsup && npm run copy-binding-to-dist && npm run copy-package && npm run copy-docs",
-    "build:full": "cd ../binding && npm run build && cd ../linker-plugins && npm run build",
-    "dev": "tsup --watch",
-    "prepublishOnly": "npm run build",
-    "pack:dist": "cd dist && npm pack",
-    "publish": "cd dist && npm publish"
-  },
   "keywords": [
     "angular",
     "linker",
@@ -77,10 +73,5 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/truonglvos/angular-rust-compiler/tree/main/packages/linker-plugins"
-  },
-  "devDependencies": {
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
-    "vite": "^6.0.0"
   }
 }

package/dist/README.md

@@ -1,306 +0,0 @@
-# angular-rust-plugins
-
-High-performance Angular linker and compiler plugins powered by Rust. Supports **Vite**, **esbuild**, **Rolldown**, and more bundlers coming soon.
-
-This package bundles the Angular Rust binding - no additional dependencies needed!
-
-## 🚀 Installation
-
-```bash
-npm install angular-rust-plugins
-```
-
-## 📋 Quick Start
-
-### 1. Create `index.html`
-
-Create an `index.html` file at the root of your project:
-
-```html
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <title>My Angular App</title>
-  <base href="/">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <link rel="icon" type="image/x-icon" href="favicon.ico">
-</head>
-<body>
-  <app-root></app-root>
-  <script type="module" src="/src/main.ts"></script>
-</body>
-</html>
-```
-
-### 2. Create `vite.config.mjs`
-
-```js
-import { defineConfig } from "vite";
-import { angularLinkerRolldownPlugin } from "angular-rust-plugins/linker/rolldown";
-import { angularCompilerVitePlugin } from "angular-rust-plugins/compiler/vite";
-
-export default defineConfig({
-  plugins: [
-    // Linker plugin - processes @angular/* packages in node_modules
-    angularLinkerRolldownPlugin(),
-    // Compiler plugin - compiles your .ts files with Angular decorators
-    angularCompilerVitePlugin(),
-  ],
-  resolve: {
-    extensions: [".ts", ".js", ".json"],
-  },
-  server: {
-    port: 4200,
-  },
-  optimizeDeps: {
-    // Exclude Angular packages from pre-bundling so linker plugin can process them
-    exclude: [
-      "@angular/core",
-      "@angular/common",
-      "@angular/platform-browser",
-      "@angular/router",
-      "@angular/forms",
-    ],
-    // Still include zone.js and rxjs which don't need linking
-    include: ["zone.js", "rxjs", "rxjs/operators"],
-  },
-});
-```
-
-### 3. Run dev server
-
-```bash
-npx vite
-```
-
-## 📖 Complete Configuration Examples
-
-### Full Angular Setup with Vite (Recommended)
-
-```js
-// vite.config.mjs
-import { defineConfig } from "vite";
-import { angularLinkerRolldownPlugin } from "angular-rust-plugins/linker/rolldown";
-import { angularCompilerVitePlugin } from "angular-rust-plugins/compiler/vite";
-
-export default defineConfig({
-  plugins: [
-    angularLinkerRolldownPlugin({ debug: false }),
-    angularCompilerVitePlugin({ debug: false }),
-  ],
-  resolve: {
-    extensions: [".ts", ".js", ".json"],
-  },
-  server: {
-    port: 4200,
-    open: true, // Open browser automatically
-  },
-  build: {
-    target: "esnext",
-    sourcemap: true,
-  },
-  optimizeDeps: {
-    exclude: [
-      "@angular/core",
-      "@angular/common",
-      "@angular/platform-browser",
-      "@angular/router",
-      "@angular/forms",
-      "@angular/animations",
-      "@angular/platform-browser-dynamic",
-    ],
-    include: ["zone.js", "rxjs", "rxjs/operators"],
-  },
-});
-```
-
-### Linker Only (Vite) - For existing Angular projects
-
-If you only need the linker (for pre-AOT compiled Angular libraries):
-
-```js
-import { defineConfig } from "vite";
-import { angularLinkerVitePlugin } from "angular-rust-plugins/linker/vite";
-
-export default defineConfig({
-  plugins: [angularLinkerVitePlugin()],
-  optimizeDeps: {
-    exclude: ["@angular/core", "@angular/common", "@angular/platform-browser"],
-  },
-});
-```
-
-### Linker with Rolldown (for Vite 6+)
-
-```js
-import { defineConfig } from "vite";
-import { angularLinkerRolldownPlugin } from "angular-rust-plugins/linker/rolldown";
-
-export default defineConfig({
-  plugins: [angularLinkerRolldownPlugin()],
-  optimizeDeps: {
-    exclude: ["@angular/core", "@angular/common", "@angular/platform-browser"],
-  },
-});
-```
-
-### Linker with esbuild
-
-```js
-import esbuild from "esbuild";
-import { angularLinkerEsbuildPlugin } from "angular-rust-plugins/linker/esbuild";
-
-esbuild.build({
-  entryPoints: ["src/main.ts"],
-  bundle: true,
-  outfile: "dist/bundle.js",
-  plugins: [angularLinkerEsbuildPlugin()],
-});
-```
-
-## 📦 Package Exports
-
-| Export Path                            | Description                        |
-| -------------------------------------- | ---------------------------------- |
-| `angular-rust-plugins`                 | All plugins                        |
-| **Linker Plugins**                     |                                    |
-| `angular-rust-plugins/linker`          | All linker plugins                 |
-| `angular-rust-plugins/linker/vite`     | Vite linker plugin (esbuild-based) |
-| `angular-rust-plugins/linker/esbuild`  | esbuild linker plugin              |
-| `angular-rust-plugins/linker/rolldown` | Rolldown linker plugin             |
-| **Compiler Plugins**                   |                                    |
-| `angular-rust-plugins/compiler`        | All compiler plugins               |
-| `angular-rust-plugins/compiler/vite`   | Vite compiler plugin               |
-
-## ⚙️ Options
-
-### Linker Options
-
-```ts
-interface LinkerOptions {
-  debug?: boolean; // Enable debug logging (default: false)
-  bindingPath?: string; // Custom path to binding (optional)
-}
-```
-
-### Compiler Options
-
-```ts
-interface CompilerOptions {
-  debug?: boolean; // Enable debug logging (default: false)
-  bindingPath?: string; // Custom path to binding (optional)
-}
-```
-
-## 📁 Project Structure
-
-Your Angular project should have this structure:
-
-```
-my-angular-app/
-├── index.html           # Entry HTML file
-├── vite.config.mjs      # Vite configuration
-├── package.json
-├── tsconfig.json
-├── src/
-│   ├── main.ts          # Bootstrap entry
-│   ├── styles.css       # Global styles
-│   └── app/
-│       ├── app.ts       # Root component
-│       ├── app.html     # Root template
-│       └── app.config.ts # App configuration
-└── public/
-    └── favicon.ico
-```
-
-### Example `src/main.ts`
-
-```ts
-import { bootstrapApplication } from "@angular/platform-browser";
-import { appConfig } from "./app/app.config";
-import { App } from "./app/app";
-
-bootstrapApplication(App, appConfig).catch((err) => console.error(err));
-```
-
-### Example `src/app/app.ts`
-
-```ts
-import { Component } from "@angular/core";
-
-@Component({
-  selector: "app-root",
-  standalone: true,
-  templateUrl: "./app.html",
-  styleUrl: "./app.css",
-})
-export class App {
-  title = "My Angular App";
-}
-```
-
-## 🔧 Troubleshooting
-
-### Angular packages not being linked
-
-Make sure Angular packages are excluded from `optimizeDeps`:
-
-```js
-optimizeDeps: {
-  exclude: [
-    "@angular/core",
-    "@angular/common",
-    "@angular/platform-browser",
-    // Add other @angular/* packages you use
-  ],
-}
-```
-
-### TypeScript compilation errors
-
-Ensure your `tsconfig.json` includes:
-
-```json
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
-  }
-}
-```
-
-### HMR (Hot Module Replacement)
-
-The compiler plugin includes HMR support for `.html` template files. When you modify a template, the corresponding component will be recompiled automatically.
-
-## ⚡ Performance
-
-**2-5x faster** than TypeScript-based Angular compiler with lower memory usage.
-
-| Metric          | angular-rust-plugins | Angular CLI |
-| --------------- | -------------------- | ----------- |
-| Initial compile | ~500ms               | ~2000ms     |
-| HMR update      | ~50ms                | ~200ms      |
-| Memory usage    | ~100MB               | ~500MB      |
-
-## 🔧 Development
-
-```bash
-# Build with current binding
-npm run build
-
-# Rebuild binding and plugin
-npm run build:full
-```
-
-## 📝 License
-
-MIT
-
----
-
-**Built with ❤️ using Rust**

package/dist/package.json

@@ -1,77 +0,0 @@
-{
-  "name": "angular-rust-plugins",
-  "version": "0.2.0",
-  "description": "Angular plugins for bundlers (Vite, esbuild, Rolldown, Webpack, Rspack) - powered by Rust compiler",
-  "author": "Truonglv4",
-  "license": "MIT",
-  "type": "module",
-  "main": "./index.cjs",
-  "module": "./index.js",
-  "types": "./index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js",
-      "require": "./index.cjs"
-    },
-    "./linker": {
-      "types": "./linker/index.d.ts",
-      "import": "./linker/index.js",
-      "require": "./linker/index.cjs"
-    },
-    "./linker/vite": {
-      "types": "./linker/vite.d.ts",
-      "import": "./linker/vite.js",
-      "require": "./linker/vite.cjs"
-    },
-    "./linker/esbuild": {
-      "types": "./linker/esbuild.d.ts",
-      "import": "./linker/esbuild.js",
-      "require": "./linker/esbuild.cjs"
-    },
-    "./linker/rolldown": {
-      "types": "./linker/rolldown.d.ts",
-      "import": "./linker/rolldown.js",
-      "require": "./linker/rolldown.cjs"
-    },
-    "./compiler": {
-      "types": "./compiler/index.d.ts",
-      "import": "./compiler/index.js",
-      "require": "./compiler/index.cjs"
-    },
-    "./compiler/vite": {
-      "types": "./compiler/vite.d.ts",
-      "import": "./compiler/vite.js",
-      "require": "./compiler/vite.cjs"
-    }
-  },
-  "files": [
-    "binding",
-    "linker",
-    "compiler",
-    "index.js",
-    "index.cjs",
-    "index.d.ts",
-    "index.d.cts",
-    "*.map",
-    "types-*.d.ts",
-    "types-*.d.cts"
-  ],
-  "keywords": [
-    "angular",
-    "linker",
-    "compiler",
-    "vite",
-    "esbuild",
-    "rolldown",
-    "webpack",
-    "rspack",
-    "rust",
-    "aot",
-    "bundler"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/truonglvos/angular-rust-compiler/tree/main/packages/linker-plugins"
-  }
-}