Add angular example

Author: nxnom

examples/angular-ecommerce/README.md

@@ -0,0 +1,40 @@
+# Angular E-commerce (Spoosh)
+
+E-commerce demo showcasing the Spoosh data layer with `@spoosh/angular` —
+built with standalone components, signals, the new control flow (`@if`, `@for`,
+`@switch`), `input()` route bindings, and `output()`.
+
+It mirrors the [`react-ecommerce`](../react-ecommerce) example feature-for-feature,
+so you can compare the exact same app across both frameworks.
+
+## Spoosh Features Demonstrated
+
+- **Reactive reads** — `injectRead` re-runs automatically when a signal it
+  reads (page number, route id) changes
+- **Optimistic updates** — instant UI feedback for likes, comments, and cart
+  actions, with automatic rollback on failure
+- **Automatic invalidation** — mutations invalidate related queries by path tag
+- **Polling** — order status refreshes every 2s until paid (`pollingPlugin`)
+- **Hover prefetch** — preload product details on hover with `prefetch`
+- **Transform** — derived cart totals via `transformPlugin` (`meta().transformedData`)
+- **Smart retry** — retry failed requests on 5xx only
+- **Cache & deduplication** — efficient fetching with `cachePlugin` and
+  `deduplicationPlugin`
+
+## Mocking
+
+API requests are mocked in the browser with [MSW](https://mswjs.io), so no
+backend is required. The worker script lives in `public/mockServiceWorker.js`.
+If it ever goes missing, regenerate it:
+
+```bash
+pnpm --filter @spoosh/example-angular-ecommerce msw:init
+```
+
+## Run
+
+```bash
+pnpm --filter @spoosh/example-angular-ecommerce dev
+```
+
+Then open the printed local URL (defaults to http://localhost:4204).

examples/angular-ecommerce/angular.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "angular-ecommerce": {
+      "projectType": "application",
+      "schematics": {},
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:application",
+          "options": {
+            "outputPath": "dist/angular-ecommerce",
+            "index": "src/index.html",
+            "browser": "src/main.ts",
+            "polyfills": ["zone.js"],
+            "tsConfig": "tsconfig.app.json",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "public"
+              }
+            ],
+            "styles": ["src/styles.css"],
+            "scripts": []
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "800kB",
+                  "maximumError": "2MB"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB",
+                  "maximumError": "8kB"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "options": {
+            "prebundle": false
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "angular-ecommerce:build:production"
+            },
+            "development": {
+              "buildTarget": "angular-ecommerce:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        }
+      }
+    }
+  },
+  "cli": {
+    "analytics": false
+  }
+}

examples/angular-ecommerce/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@spoosh/example-angular-ecommerce",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "ng": "ng",
+    "dev": "ng serve --port 4204",
+    "build": "ng build",
+    "preview": "ng serve --port 4214 --configuration production",
+    "typecheck": "ng build --configuration development",
+    "lint": "eslint 'src/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "msw:init": "msw init public --save"
+  },
+  "dependencies": {
+    "@angular/common": "21.2.16",
+    "@angular/compiler": "21.2.16",
+    "@angular/core": "21.2.16",
+    "@angular/forms": "21.2.16",
+    "@angular/platform-browser": "21.2.16",
+    "@angular/router": "21.2.16",
+    "@spoosh/core": "workspace:*",
+    "@spoosh/devtool": "workspace:*",
+    "@spoosh/plugin-cache": "workspace:*",
+    "@spoosh/plugin-debounce": "workspace:*",
+    "@spoosh/plugin-deduplication": "workspace:*",
+    "@spoosh/plugin-gc": "workspace:*",
+    "@spoosh/plugin-invalidation": "workspace:*",
+    "@spoosh/plugin-optimistic": "workspace:*",
+    "@spoosh/plugin-polling": "workspace:*",
+    "@spoosh/plugin-prefetch": "workspace:*",
+    "@spoosh/plugin-progress": "workspace:*",
+    "@spoosh/plugin-refetch": "workspace:*",
+    "@spoosh/plugin-retry": "workspace:*",
+    "@spoosh/plugin-transform": "workspace:*",
+    "@spoosh/angular": "workspace:*",
+    "msw": "^2.11.3",
+    "rxjs": "~7.8.0",
+    "tslib": "^2.3.0",
+    "zone.js": "~0.15.0"
+  },
+  "devDependencies": {
+    "@angular-devkit/build-angular": "21.2.14",
+    "@angular/cli": "21.2.14",
+    "@angular/compiler-cli": "21.2.16",
+    "@types/node": "^20.0.0",
+    "typescript": "~5.9.2"
+  }
+}