feat: minimal signals + RemoteData template with a users feature

Extracted from atomic-design-poc: RemoteData<E,T> (bare union + fromResource,
no combinators) + a trimmed <app-async> switch, no Elm-style store — state is
resource() plus one plain signal. Minimal DDD layering per context
(domain/infrastructure/application/ui) combined with atomic design inside
ui/ (atoms/molecules/organisms/templates/pages), mirroring the POC's
conventions at template scale.

One worked feature (users/): a list with a click-through to a detail view
(its own independent resource() fetch) and a Back action. Tests are
BDD-style (describe/it, one assertion per it) and black-box (assert
rendered DOM/emitted events only) - 100% branch/line coverage. README.md
documents what's deliberately omitted vs. the POC and the concrete growth
path back to it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
eho
2026-07-31 23:27:09 +02:00
co-authored by Claude Sonnet 5
parent 209df1ae5a
commit 927404afd7
29 changed files with 778 additions and 418 deletions
+74 -44
View File
@@ -1,59 +1,89 @@
# NgSignalsTemplate
# ng-signals-template
This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.1.2.
A minimal Angular 22 starter: signals for state, `resource()` for async data, and a
`RemoteData` type that makes "loading but has an error," "success with no value," and
similar illegal combinations impossible to construct. One worked feature (`users/`) shows
the whole pattern end to end, including an action (click a user → see their details →
go back).
## Development server
It's extracted from a larger reference app — the "POC" referenced throughout this
document — which shows the same ideas grown up to production scale (multi-context DDD,
enforced architecture boundaries, i18n, a real design system, generated API clients). This
template deliberately keeps only the part of that setup useful from day one, and documents
exactly where to reach for the rest as a project grows.
To start a local development server, run:
## Running it
```bash
ng serve
npm start # ng serve
npm test # ng test (Vitest)
```
Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files.
## What's here
## Code scaffolding
- **`RemoteData<E, T>`** (`shared/application/remote-data.ts`) — a 4-variant union
(`Loading | Empty | Failure | Success`) plus `fromResource()`, which projects Angular's
own `resource()` into one. No store, no reducer — `resource()` already holds the async
state; `RemoteData` just normalizes it for exhaustive rendering.
- **`<app-async>`** (`shared/ui/molecules/async.component.ts`) — a `@switch` over all 4
states: a spinner while loading, an empty message, a failure message with a retry
button, or your projected content on success. Reused by both fetches in `users/`.
- **`<app-page-shell>`** (`shared/ui/templates/page-shell.component.ts`) — a heading plus
one content slot. That's it.
- **`users/`** — one feature context, laid out the same way a bigger one would be:
`domain/` (pure types, no Angular import), `infrastructure/` (the only file allowed to
call `fetch`), `application/` (composes infrastructure + `resource()` — this is also
exactly where a real store would slot in later), `ui/` (organisms + the page). Clicking
a user in the list sets one plain `signal` on the page, which swaps in a
`UserDetailComponent` that does its own independent fetch.
- Path aliases `@shared/*` and `@users/*` (see `tsconfig.json`) instead of relative
`../../` imports, one per context — add one per new context you create.
- Tests are BDD-style (`describe`/`it`, one `expect` per `it`) and black-box: they assert
on rendered DOM and emitted events, never on a component's private fields, so a test
never breaks just because an internal was refactored.
Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
## What's deliberately not here (vs. the POC)
```bash
ng generate component component-name
```
| Missing | Why |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Elm-style store (`createStore`/Model-Msg-reduce) | Not needed until a page's state has more than a couple of interacting fields — see Growth path below. |
| i18n (`$localize` + translation file) | POC-specific requirement (a Dutch app shipping English too); irrelevant for a single-locale starter. |
| CIBG Huisstijl theming / token bridge | The POC's specific design system; a starter has no house style to vendor yet. |
| `dependency-cruiser` boundary enforcement | Real value once you have 2+ contexts that must not import each other; overhead for one. |
| `contracts/` layer + generated API client + `parse*` boundary | Only earns its keep once you're consuming a real backend's OpenAPI contract, not a public test API. |
| Storybook + axe a11y gate | Testing/documentation infrastructure that pays off at a much bigger component count. |
| CI pipeline | Nothing to gate yet with one context and no deploy target. |
For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
## Growth path — when you outgrow this
```bash
ng generate --help
```
Each of these is a real, working pattern in the POC — copy it when you actually need it,
not before:
## Building
- **A page's state grows past 2-3 interacting fields, or needs undo/multi-step flow** →
add an Elm-style store: `shared/application/store.ts` (`createStore`) +
a `*.machine.ts` per feature (Model/Msg/pure `reduce`).
- **You have 2+ contexts that must not import each other** → add
`dependency-cruiser` (`.dependency-cruiser.js`) to enforce the `domain → application →
infrastructure`/`ui` direction this template already follows by convention but doesn't
check.
- **You're consuming a real backend's OpenAPI contract** → add a `contracts/` layer
(wire DTOs) + a generated typed client + a hand-written `parse*` boundary in
`infrastructure/` (see ADR-0001, `.claude/skills/bff-endpoint/SKILL.md` if you're
working from the POC directly).
- **A second locale** → wrap user-facing copy in `$localize` with a stable custom id and
add a translation `.xlf` file (see the POC's `CLAUDE.md` "User-facing copy" convention).
- **A real design system** → vendor your CSS, then bridge your own token names onto it the
way ADR-0003 (`docs/reference/architecture/0003-cibg-huisstijl.md` in the POC) does —
keep your token names stable, only their values change.
- **Testing/a11y at real component count** → add Storybook + the axe a11y addon so every
component's states are visually verifiable and accessibility-checked, not just
behavior-tested.
To build the project run:
## Folder convention
```bash
ng build
```
This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed.
## Running unit tests
To execute unit tests with the [Vitest](https://vitest.dev/) test runner, use the following command:
```bash
ng test
```
## Running end-to-end tests
For end-to-end (e2e) testing, run:
```bash
ng e2e
```
Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
## Additional Resources
For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
Each business capability is a context under `src/app/<context>/`, split into
`domain/application/infrastructure/ui` — dependencies point inward
(`ui → application → domain`; only `application` reaches `infrastructure`). Inside a
context's `ui/`, components are organized by atomic-design layer (`atoms → molecules →
organisms → templates → pages`); `shared/` holds only cross-context building blocks. When
you add a second context, mirror `users/`'s shape.
+2 -1
View File
@@ -2,7 +2,8 @@
"$schema": "./node_modules/@angular/cli/lib/config/schema.json",
"version": 1,
"cli": {
"packageManager": "npm"
"packageManager": "npm",
"analytics": false
},
"newProjectRoot": "projects",
"projects": {
+201
View File
@@ -21,6 +21,7 @@
"@angular/build": "^22.1.2",
"@angular/cli": "^22.1.2",
"@angular/compiler-cli": "^22.1.0",
"@vitest/coverage-v8": "^4.1.10",
"jsdom": "^28.0.0",
"prettier": "^3.8.1",
"typescript": "~6.0.2",
@@ -756,6 +757,16 @@
"node": "^22.18.0 || >=24.11.0"
}
},
"node_modules/@bcoe/v8-coverage": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-1.0.2.tgz",
"integrity": "sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=18"
}
},
"node_modules/@bramus/specificity": {
"version": "2.4.2",
"resolved": "https://registry.npmjs.org/@bramus/specificity/-/specificity-2.4.2.tgz",
@@ -3472,6 +3483,37 @@
"vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
}
},
"node_modules/@vitest/coverage-v8": {
"version": "4.1.10",
"resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-4.1.10.tgz",
"integrity": "sha512-IM49HmthevbgAO4anp1hwtoT9wYe59w0LR00gr+eagHE+ZJ5lK4sLPeO0ubgoJcwLk6dehU3R24N+FbEEKDc8g==",
"dev": true,
"license": "MIT",
"dependencies": {
"@bcoe/v8-coverage": "^1.0.2",
"@vitest/utils": "4.1.10",
"ast-v8-to-istanbul": "^1.0.0",
"istanbul-lib-coverage": "^3.2.2",
"istanbul-lib-report": "^3.0.1",
"istanbul-reports": "^3.2.0",
"magicast": "^0.5.2",
"obug": "^2.1.1",
"std-env": "^4.0.0-rc.1",
"tinyrainbow": "^3.1.0"
},
"funding": {
"url": "https://opencollective.com/vitest"
},
"peerDependencies": {
"@vitest/browser": "4.1.10",
"vitest": "4.1.10"
},
"peerDependenciesMeta": {
"@vitest/browser": {
"optional": true
}
}
},
"node_modules/@vitest/expect": {
"version": "4.1.10",
"resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.10.tgz",
@@ -3723,6 +3765,18 @@
"node": ">=12"
}
},
"node_modules/ast-v8-to-istanbul": {
"version": "1.0.5",
"resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-1.0.5.tgz",
"integrity": "sha512-UPAgKJFSEGMWSDr3LX4tqnAb4f7KGT8O40Tyx8wbYmmZ/yn58lNCm8h3svs3eXgiGd5AXxz8NDOvXWvicq+rJA==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/trace-mapping": "^0.3.31",
"estree-walker": "^3.0.3",
"js-tokens": "^10.0.0"
}
},
"node_modules/baseline-browser-mapping": {
"version": "2.11.9",
"resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.9.tgz",
@@ -4864,6 +4918,16 @@
"dev": true,
"license": "ISC"
},
"node_modules/has-flag": {
"version": "4.0.0",
"resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
"integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=8"
}
},
"node_modules/has-symbols": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
@@ -4926,6 +4990,13 @@
"node": "^20.19.0 || ^22.12.0 || >=24.0.0"
}
},
"node_modules/html-escaper": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
"integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==",
"dev": true,
"license": "MIT"
},
"node_modules/htmlparser2": {
"version": "10.1.0",
"resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz",
@@ -5169,6 +5240,45 @@
"dev": true,
"license": "ISC"
},
"node_modules/istanbul-lib-coverage": {
"version": "3.2.2",
"resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz",
"integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==",
"dev": true,
"license": "BSD-3-Clause",
"engines": {
"node": ">=8"
}
},
"node_modules/istanbul-lib-report": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz",
"integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==",
"dev": true,
"license": "BSD-3-Clause",
"dependencies": {
"istanbul-lib-coverage": "^3.0.0",
"make-dir": "^4.0.0",
"supports-color": "^7.1.0"
},
"engines": {
"node": ">=10"
}
},
"node_modules/istanbul-reports": {
"version": "3.2.0",
"resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz",
"integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==",
"dev": true,
"license": "BSD-3-Clause",
"dependencies": {
"html-escaper": "^2.0.0",
"istanbul-lib-report": "^3.0.0"
},
"engines": {
"node": ">=8"
}
},
"node_modules/jose": {
"version": "6.2.6",
"resolved": "https://registry.npmjs.org/jose/-/jose-6.2.6.tgz",
@@ -5728,6 +5838,84 @@
"@jridgewell/sourcemap-codec": "^1.5.5"
}
},
"node_modules/magicast": {
"version": "0.5.4",
"resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.4.tgz",
"integrity": "sha512-llBEhWm1SacoRwgHUoQJYtwp4PBLF4faQi5TCpIGyGs9n4y5+juI0tDgyKIfpqxckRHaHzouUEph3THklWh03w==",
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/parser": "^7.29.7",
"@babel/types": "^7.29.7",
"source-map-js": "^1.2.1"
}
},
"node_modules/magicast/node_modules/@babel/helper-string-parser": {
"version": "7.29.7",
"resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
"integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=6.9.0"
}
},
"node_modules/magicast/node_modules/@babel/helper-validator-identifier": {
"version": "7.29.7",
"resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
"integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=6.9.0"
}
},
"node_modules/magicast/node_modules/@babel/parser": {
"version": "7.29.8",
"resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz",
"integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==",
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/types": "^7.29.8"
},
"bin": {
"parser": "bin/babel-parser.js"
},
"engines": {
"node": ">=6.0.0"
}
},
"node_modules/magicast/node_modules/@babel/types": {
"version": "7.29.8",
"resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
"integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/helper-string-parser": "^7.29.7",
"@babel/helper-validator-identifier": "^7.29.7"
},
"engines": {
"node": ">=6.9.0"
}
},
"node_modules/make-dir": {
"version": "4.0.0",
"resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz",
"integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==",
"dev": true,
"license": "MIT",
"dependencies": {
"semver": "^7.5.3"
},
"engines": {
"node": ">=10"
},
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/math-intrinsics": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -6916,6 +7104,19 @@
"url": "https://github.com/chalk/strip-ansi?sponsor=1"
}
},
"node_modules/supports-color": {
"version": "7.2.0",
"resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
"integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
"dev": true,
"license": "MIT",
"dependencies": {
"has-flag": "^4.0.0"
},
"engines": {
"node": ">=8"
}
},
"node_modules/symbol-tree": {
"version": "3.2.4",
"resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+2 -1
View File
@@ -24,9 +24,10 @@
"@angular/build": "^22.1.2",
"@angular/cli": "^22.1.2",
"@angular/compiler-cli": "^22.1.0",
"@vitest/coverage-v8": "^4.1.10",
"jsdom": "^28.0.0",
"prettier": "^3.8.1",
"typescript": "~6.0.2",
"vitest": "^4.0.8"
}
}
}
+1 -4
View File
@@ -1,8 +1,5 @@
import { ApplicationConfig, provideBrowserGlobalErrorListeners } from '@angular/core';
export const appConfig: ApplicationConfig = {
providers: [
provideBrowserGlobalErrorListeners(),
]
providers: [provideBrowserGlobalErrorListeners()],
};
+1 -343
View File
@@ -1,343 +1 @@
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<!-- * * * * * * * * * * * The content below * * * * * * * * * * * -->
<!-- * * * * * * * * * * is only a placeholder * * * * * * * * * * -->
<!-- * * * * * * * * * * and can be replaced. * * * * * * * * * * -->
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<!-- * * * * * * * * * Delete the template below * * * * * * * * * -->
<!-- * * * * * * * to get started with your project! * * * * * * * -->
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<style>
:host {
--bright-blue: oklch(51.01% 0.274 263.83);
--electric-violet: oklch(53.18% 0.28 296.97);
--french-violet: oklch(47.66% 0.246 305.88);
--vivid-pink: oklch(69.02% 0.277 332.77);
--hot-red: oklch(61.42% 0.238 15.34);
--orange-red: oklch(63.32% 0.24 31.68);
--gray-900: oklch(19.37% 0.006 300.98);
--gray-700: oklch(36.98% 0.014 302.71);
--gray-400: oklch(70.9% 0.015 304.04);
--red-to-pink-to-purple-vertical-gradient: linear-gradient(
180deg,
var(--orange-red) 0%,
var(--vivid-pink) 50%,
var(--electric-violet) 100%
);
--red-to-pink-to-purple-horizontal-gradient: linear-gradient(
90deg,
var(--orange-red) 0%,
var(--vivid-pink) 50%,
var(--electric-violet) 100%
);
--pill-accent: var(--bright-blue);
font-family: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji",
"Segoe UI Symbol";
box-sizing: border-box;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
display: block;
height: 100dvh;
}
h1 {
font-size: 3.125rem;
color: var(--gray-900);
font-weight: 500;
line-height: 100%;
letter-spacing: -0.125rem;
margin: 0;
font-family: "Inter Tight", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji",
"Segoe UI Symbol";
}
p {
margin: 0;
color: var(--gray-700);
}
main {
width: 100%;
min-height: 100%;
display: flex;
justify-content: center;
align-items: center;
padding: 1rem;
box-sizing: inherit;
position: relative;
}
.angular-logo {
max-width: 9.2rem;
}
.content {
display: flex;
justify-content: space-around;
width: 100%;
max-width: 700px;
margin-bottom: 3rem;
}
.content h1 {
margin-top: 1.75rem;
}
.content p {
margin-top: 1.5rem;
}
.divider {
width: 1px;
background: var(--red-to-pink-to-purple-vertical-gradient);
margin-inline: 0.5rem;
}
.pill-group {
display: flex;
flex-direction: column;
align-items: start;
flex-wrap: wrap;
gap: 1.25rem;
}
.pill {
display: flex;
align-items: center;
--pill-accent: var(--bright-blue);
background: color-mix(in srgb, var(--pill-accent) 5%, transparent);
color: var(--pill-accent);
padding-inline: 0.75rem;
padding-block: 0.375rem;
border-radius: 2.75rem;
border: 0;
transition: background 0.3s ease;
font-family: var(--inter-font);
font-size: 0.875rem;
font-style: normal;
font-weight: 500;
line-height: 1.4rem;
letter-spacing: -0.00875rem;
text-decoration: none;
white-space: nowrap;
}
.pill:hover {
background: color-mix(in srgb, var(--pill-accent) 15%, transparent);
}
.pill-group .pill:nth-child(6n + 1) {
--pill-accent: var(--bright-blue);
}
.pill-group .pill:nth-child(6n + 2) {
--pill-accent: var(--electric-violet);
}
.pill-group .pill:nth-child(6n + 3) {
--pill-accent: var(--french-violet);
}
.pill-group .pill:nth-child(6n + 4),
.pill-group .pill:nth-child(6n + 5),
.pill-group .pill:nth-child(6n + 6) {
--pill-accent: var(--hot-red);
}
.pill-group svg {
margin-inline-start: 0.25rem;
}
.social-links {
display: flex;
align-items: center;
gap: 0.73rem;
margin-top: 1.5rem;
}
.social-links path {
transition: fill 0.3s ease;
fill: var(--gray-400);
}
.social-links a:hover svg path {
fill: var(--gray-900);
}
@media screen and (max-width: 650px) {
.content {
flex-direction: column;
width: max-content;
}
.divider {
height: 1px;
width: 100%;
background: var(--red-to-pink-to-purple-horizontal-gradient);
margin-block: 1.5rem;
}
}
</style>
<main class="main">
<div class="content">
<div class="left-side">
<svg
xmlns="http://www.w3.org/2000/svg"
viewBox="0 0 982 239"
fill="none"
class="angular-logo"
>
<g clip-path="url(#a)">
<path
fill="url(#b)"
d="M388.676 191.625h30.849L363.31 31.828h-35.758l-56.215 159.797h30.848l13.174-39.356h60.061l13.256 39.356Zm-65.461-62.675 21.602-64.311h1.227l21.602 64.311h-44.431Zm126.831-7.527v70.202h-28.23V71.839h27.002v20.374h1.392c2.782-6.71 7.2-12.028 13.255-15.956 6.056-3.927 13.584-5.89 22.503-5.89 8.264 0 15.465 1.8 21.684 5.318 6.137 3.518 10.964 8.673 14.319 15.382 3.437 6.71 5.074 14.81 4.992 24.383v76.175h-28.23v-71.92c0-8.019-2.046-14.237-6.219-18.819-4.173-4.5-9.819-6.791-17.102-6.791-4.91 0-9.328 1.063-13.174 3.272-3.846 2.128-6.792 5.237-9.001 9.328-2.046 4.009-3.191 8.918-3.191 14.728ZM589.233 239c-10.147 0-18.82-1.391-26.103-4.091-7.282-2.7-13.092-6.382-17.511-10.964-4.418-4.582-7.528-9.655-9.164-15.219l25.448-6.136c1.145 2.372 2.782 4.663 4.991 6.954 2.209 2.291 5.155 4.255 8.837 5.81 3.683 1.554 8.428 2.291 14.074 2.291 8.019 0 14.647-1.964 19.884-5.81 5.237-3.845 7.856-10.227 7.856-19.064v-22.665h-1.391c-1.473 2.946-3.601 5.892-6.383 9.001-2.782 3.109-6.464 5.645-10.965 7.691-4.582 2.046-10.228 3.109-17.101 3.109-9.165 0-17.511-2.209-25.039-6.545-7.446-4.337-13.42-10.883-17.757-19.474-4.418-8.673-6.628-19.473-6.628-32.565 0-13.091 2.21-24.301 6.628-33.383 4.419-9.082 10.311-15.955 17.839-20.7 7.528-4.746 15.874-7.037 25.039-7.037 7.037 0 12.846 1.145 17.347 3.518 4.582 2.373 8.182 5.236 10.883 8.51 2.7 3.272 4.746 6.382 6.137 9.327h1.554v-19.8h27.821v121.749c0 10.228-2.454 18.737-7.364 25.447-4.91 6.709-11.538 11.7-20.048 15.055-8.509 3.355-18.165 4.991-28.884 4.991Zm.245-71.266c5.974 0 11.047-1.473 15.302-4.337 4.173-2.945 7.446-7.118 9.573-12.519 2.21-5.482 3.274-12.027 3.274-19.637 0-7.609-1.064-14.155-3.274-19.8-2.127-5.646-5.318-10.064-9.491-13.255-4.174-3.11-9.329-4.746-15.384-4.746s-11.537 1.636-15.792 4.91c-4.173 3.272-7.365 7.772-9.492 13.418-2.128 5.727-3.191 12.191-3.191 19.392 0 7.2 1.063 13.745 3.273 19.228 2.127 5.482 5.318 9.736 9.573 12.764 4.174 3.027 9.41 4.582 15.629 4.582Zm141.56-26.51V71.839h28.23v119.786h-27.412v-21.273h-1.227c-2.7 6.709-7.119 12.191-13.338 16.446-6.137 4.255-13.747 6.382-22.748 6.382-7.855 0-14.81-1.718-20.783-5.237-5.974-3.518-10.72-8.591-14.075-15.382-3.355-6.709-5.073-14.891-5.073-24.464V71.839h28.312v71.921c0 7.609 2.046 13.664 6.219 18.083 4.173 4.5 9.655 6.709 16.365 6.709 4.173 0 8.183-.982 12.111-3.028 3.927-2.045 7.118-5.072 9.655-9.082 2.537-4.091 3.764-9.164 3.764-15.218Zm65.707-109.395v159.796h-28.23V31.828h28.23Zm44.841 162.169c-7.61 0-14.402-1.391-20.457-4.091-6.055-2.7-10.883-6.791-14.32-12.109-3.518-5.319-5.237-11.946-5.237-19.801 0-6.791 1.228-12.355 3.765-16.773 2.536-4.419 5.891-7.937 10.228-10.637 4.337-2.618 9.164-4.664 14.647-6.055 5.4-1.391 11.046-2.373 16.856-3.027 7.037-.737 12.683-1.391 17.102-1.964 4.337-.573 7.528-1.555 9.574-2.782 1.963-1.309 3.027-3.273 3.027-5.973v-.491c0-5.891-1.718-10.391-5.237-13.664-3.518-3.191-8.51-4.828-15.056-4.828-6.955 0-12.356 1.473-16.447 4.5-4.009 3.028-6.71 6.546-8.183 10.719l-26.348-3.764c2.046-7.282 5.483-13.336 10.31-18.328 4.746-4.909 10.638-8.59 17.511-11.045 6.955-2.455 14.565-3.682 22.912-3.682 5.809 0 11.537.654 17.265 2.045s10.965 3.6 15.711 6.71c4.746 3.109 8.51 7.282 11.455 12.6 2.864 5.318 4.337 11.946 4.337 19.883v80.184h-27.166v-16.446h-.9c-1.719 3.355-4.092 6.464-7.201 9.328-3.109 2.864-6.955 5.237-11.619 6.955-4.828 1.718-10.229 2.536-16.529 2.536Zm7.364-20.701c5.646 0 10.556-1.145 14.729-3.354 4.173-2.291 7.364-5.237 9.655-9.001 2.292-3.763 3.355-7.854 3.355-12.273v-14.155c-.9.737-2.373 1.391-4.5 2.046-2.128.654-4.419 1.145-7.037 1.636-2.619.491-5.155.9-7.692 1.227-2.537.328-4.746.655-6.628.901-4.173.572-8.019 1.472-11.292 2.781-3.355 1.31-5.973 3.11-7.855 5.401-1.964 2.291-2.864 5.318-2.864 8.918 0 5.237 1.882 9.164 5.728 11.782 3.682 2.782 8.51 4.091 14.401 4.091Zm64.643 18.328V71.839h27.412v19.965h1.227c2.21-6.955 5.974-12.274 11.292-16.038 5.319-3.763 11.456-5.645 18.329-5.645 1.555 0 3.355.082 5.237.163 1.964.164 3.601.328 4.91.573v25.938c-1.227-.41-3.109-.819-5.646-1.146a58.814 58.814 0 0 0-7.446-.49c-5.155 0-9.738 1.145-13.829 3.354-4.091 2.209-7.282 5.236-9.655 9.164-2.373 3.927-3.519 8.427-3.519 13.5v70.448h-28.312ZM222.077 39.192l-8.019 125.923L137.387 0l84.69 39.192Zm-53.105 162.825-57.933 33.056-57.934-33.056 11.783-28.556h92.301l11.783 28.556ZM111.039 62.675l30.357 73.803H80.681l30.358-73.803ZM7.937 165.115 0 39.192 84.69 0 7.937 165.115Z"
/>
<path
fill="url(#c)"
d="M388.676 191.625h30.849L363.31 31.828h-35.758l-56.215 159.797h30.848l13.174-39.356h60.061l13.256 39.356Zm-65.461-62.675 21.602-64.311h1.227l21.602 64.311h-44.431Zm126.831-7.527v70.202h-28.23V71.839h27.002v20.374h1.392c2.782-6.71 7.2-12.028 13.255-15.956 6.056-3.927 13.584-5.89 22.503-5.89 8.264 0 15.465 1.8 21.684 5.318 6.137 3.518 10.964 8.673 14.319 15.382 3.437 6.71 5.074 14.81 4.992 24.383v76.175h-28.23v-71.92c0-8.019-2.046-14.237-6.219-18.819-4.173-4.5-9.819-6.791-17.102-6.791-4.91 0-9.328 1.063-13.174 3.272-3.846 2.128-6.792 5.237-9.001 9.328-2.046 4.009-3.191 8.918-3.191 14.728ZM589.233 239c-10.147 0-18.82-1.391-26.103-4.091-7.282-2.7-13.092-6.382-17.511-10.964-4.418-4.582-7.528-9.655-9.164-15.219l25.448-6.136c1.145 2.372 2.782 4.663 4.991 6.954 2.209 2.291 5.155 4.255 8.837 5.81 3.683 1.554 8.428 2.291 14.074 2.291 8.019 0 14.647-1.964 19.884-5.81 5.237-3.845 7.856-10.227 7.856-19.064v-22.665h-1.391c-1.473 2.946-3.601 5.892-6.383 9.001-2.782 3.109-6.464 5.645-10.965 7.691-4.582 2.046-10.228 3.109-17.101 3.109-9.165 0-17.511-2.209-25.039-6.545-7.446-4.337-13.42-10.883-17.757-19.474-4.418-8.673-6.628-19.473-6.628-32.565 0-13.091 2.21-24.301 6.628-33.383 4.419-9.082 10.311-15.955 17.839-20.7 7.528-4.746 15.874-7.037 25.039-7.037 7.037 0 12.846 1.145 17.347 3.518 4.582 2.373 8.182 5.236 10.883 8.51 2.7 3.272 4.746 6.382 6.137 9.327h1.554v-19.8h27.821v121.749c0 10.228-2.454 18.737-7.364 25.447-4.91 6.709-11.538 11.7-20.048 15.055-8.509 3.355-18.165 4.991-28.884 4.991Zm.245-71.266c5.974 0 11.047-1.473 15.302-4.337 4.173-2.945 7.446-7.118 9.573-12.519 2.21-5.482 3.274-12.027 3.274-19.637 0-7.609-1.064-14.155-3.274-19.8-2.127-5.646-5.318-10.064-9.491-13.255-4.174-3.11-9.329-4.746-15.384-4.746s-11.537 1.636-15.792 4.91c-4.173 3.272-7.365 7.772-9.492 13.418-2.128 5.727-3.191 12.191-3.191 19.392 0 7.2 1.063 13.745 3.273 19.228 2.127 5.482 5.318 9.736 9.573 12.764 4.174 3.027 9.41 4.582 15.629 4.582Zm141.56-26.51V71.839h28.23v119.786h-27.412v-21.273h-1.227c-2.7 6.709-7.119 12.191-13.338 16.446-6.137 4.255-13.747 6.382-22.748 6.382-7.855 0-14.81-1.718-20.783-5.237-5.974-3.518-10.72-8.591-14.075-15.382-3.355-6.709-5.073-14.891-5.073-24.464V71.839h28.312v71.921c0 7.609 2.046 13.664 6.219 18.083 4.173 4.5 9.655 6.709 16.365 6.709 4.173 0 8.183-.982 12.111-3.028 3.927-2.045 7.118-5.072 9.655-9.082 2.537-4.091 3.764-9.164 3.764-15.218Zm65.707-109.395v159.796h-28.23V31.828h28.23Zm44.841 162.169c-7.61 0-14.402-1.391-20.457-4.091-6.055-2.7-10.883-6.791-14.32-12.109-3.518-5.319-5.237-11.946-5.237-19.801 0-6.791 1.228-12.355 3.765-16.773 2.536-4.419 5.891-7.937 10.228-10.637 4.337-2.618 9.164-4.664 14.647-6.055 5.4-1.391 11.046-2.373 16.856-3.027 7.037-.737 12.683-1.391 17.102-1.964 4.337-.573 7.528-1.555 9.574-2.782 1.963-1.309 3.027-3.273 3.027-5.973v-.491c0-5.891-1.718-10.391-5.237-13.664-3.518-3.191-8.51-4.828-15.056-4.828-6.955 0-12.356 1.473-16.447 4.5-4.009 3.028-6.71 6.546-8.183 10.719l-26.348-3.764c2.046-7.282 5.483-13.336 10.31-18.328 4.746-4.909 10.638-8.59 17.511-11.045 6.955-2.455 14.565-3.682 22.912-3.682 5.809 0 11.537.654 17.265 2.045s10.965 3.6 15.711 6.71c4.746 3.109 8.51 7.282 11.455 12.6 2.864 5.318 4.337 11.946 4.337 19.883v80.184h-27.166v-16.446h-.9c-1.719 3.355-4.092 6.464-7.201 9.328-3.109 2.864-6.955 5.237-11.619 6.955-4.828 1.718-10.229 2.536-16.529 2.536Zm7.364-20.701c5.646 0 10.556-1.145 14.729-3.354 4.173-2.291 7.364-5.237 9.655-9.001 2.292-3.763 3.355-7.854 3.355-12.273v-14.155c-.9.737-2.373 1.391-4.5 2.046-2.128.654-4.419 1.145-7.037 1.636-2.619.491-5.155.9-7.692 1.227-2.537.328-4.746.655-6.628.901-4.173.572-8.019 1.472-11.292 2.781-3.355 1.31-5.973 3.11-7.855 5.401-1.964 2.291-2.864 5.318-2.864 8.918 0 5.237 1.882 9.164 5.728 11.782 3.682 2.782 8.51 4.091 14.401 4.091Zm64.643 18.328V71.839h27.412v19.965h1.227c2.21-6.955 5.974-12.274 11.292-16.038 5.319-3.763 11.456-5.645 18.329-5.645 1.555 0 3.355.082 5.237.163 1.964.164 3.601.328 4.91.573v25.938c-1.227-.41-3.109-.819-5.646-1.146a58.814 58.814 0 0 0-7.446-.49c-5.155 0-9.738 1.145-13.829 3.354-4.091 2.209-7.282 5.236-9.655 9.164-2.373 3.927-3.519 8.427-3.519 13.5v70.448h-28.312ZM222.077 39.192l-8.019 125.923L137.387 0l84.69 39.192Zm-53.105 162.825-57.933 33.056-57.934-33.056 11.783-28.556h92.301l11.783 28.556ZM111.039 62.675l30.357 73.803H80.681l30.358-73.803ZM7.937 165.115 0 39.192 84.69 0 7.937 165.115Z"
/>
</g>
<defs>
<radialGradient
id="c"
cx="0"
cy="0"
r="1"
gradientTransform="rotate(118.122 171.182 60.81) scale(205.794)"
gradientUnits="userSpaceOnUse"
>
<stop stop-color="#FF41F8" />
<stop offset=".707" stop-color="#FF41F8" stop-opacity=".5" />
<stop offset="1" stop-color="#FF41F8" stop-opacity="0" />
</radialGradient>
<linearGradient
id="b"
x1="0"
x2="982"
y1="192"
y2="192"
gradientUnits="userSpaceOnUse"
>
<stop stop-color="#F0060B" />
<stop offset="0" stop-color="#F0070C" />
<stop offset=".526" stop-color="#CC26D5" />
<stop offset="1" stop-color="#7702FF" />
</linearGradient>
<clipPath id="a"><path fill="#fff" d="M0 0h982v239H0z" /></clipPath>
</defs>
</svg>
<h1>Hello, {{ title() }}</h1>
<p>Congratulations! Your app is running. 🎉</p>
</div>
<div class="divider" role="separator" aria-label="Divider"></div>
<div class="right-side">
<div class="pill-group">
@for (item of [
{ title: 'Explore the Docs', link: 'https://angular.dev' },
{ title: 'Learn with Tutorials', link: 'https://angular.dev/tutorials' },
{ title: 'Prompt and best practices for AI', link: 'https://angular.dev/ai/develop-with-ai'},
{ title: 'CLI Docs', link: 'https://angular.dev/tools/cli' },
{ title: 'Angular Language Service', link: 'https://angular.dev/tools/language-service' },
{ title: 'Angular DevTools', link: 'https://angular.dev/tools/devtools' },
]; track item.title) {
<a
class="pill"
[href]="item.link"
target="_blank"
rel="noopener"
>
<span>{{ item.title }}</span>
<svg
xmlns="http://www.w3.org/2000/svg"
height="14"
viewBox="0 -960 960 960"
width="14"
fill="currentColor"
>
<path
d="M200-120q-33 0-56.5-23.5T120-200v-560q0-33 23.5-56.5T200-840h280v80H200v560h560v-280h80v280q0 33-23.5 56.5T760-120H200Zm188-212-56-56 372-372H560v-80h280v280h-80v-144L388-332Z"
/>
</svg>
</a>
}
</div>
<div class="social-links">
<a
href="https://github.com/angular/angular"
aria-label="Github"
target="_blank"
rel="noopener"
>
<svg
width="25"
height="24"
viewBox="0 0 25 24"
fill="none"
xmlns="http://www.w3.org/2000/svg"
alt="Github"
>
<path
d="M12.3047 0C5.50634 0 0 5.50942 0 12.3047C0 17.7423 3.52529 22.3535 8.41332 23.9787C9.02856 24.0946 9.25414 23.7142 9.25414 23.3871C9.25414 23.0949 9.24389 22.3207 9.23876 21.2953C5.81601 22.0377 5.09414 19.6444 5.09414 19.6444C4.53427 18.2243 3.72524 17.8449 3.72524 17.8449C2.61064 17.082 3.81137 17.0973 3.81137 17.0973C5.04697 17.1835 5.69604 18.3647 5.69604 18.3647C6.79321 20.2463 8.57636 19.7029 9.27978 19.3881C9.39052 18.5924 9.70736 18.0499 10.0591 17.7423C7.32641 17.4347 4.45429 16.3765 4.45429 11.6618C4.45429 10.3185 4.9311 9.22133 5.72065 8.36C5.58222 8.04931 5.16694 6.79833 5.82831 5.10337C5.82831 5.10337 6.85883 4.77319 9.2121 6.36459C10.1965 6.09082 11.2424 5.95546 12.2883 5.94931C13.3342 5.95546 14.3801 6.09082 15.3644 6.36459C17.7023 4.77319 18.7328 5.10337 18.7328 5.10337C19.3942 6.79833 18.9789 8.04931 18.8559 8.36C19.6403 9.22133 20.1171 10.3185 20.1171 11.6618C20.1171 16.3888 17.2409 17.4296 14.5031 17.7321C14.9338 18.1012 15.3337 18.8559 15.3337 20.0084C15.3337 21.6552 15.3183 22.978 15.3183 23.3779C15.3183 23.7009 15.5336 24.0854 16.1642 23.9623C21.0871 22.3484 24.6094 17.7341 24.6094 12.3047C24.6094 5.50942 19.0999 0 12.3047 0Z"
/>
</svg>
</a>
<a
href="https://x.com/angular"
aria-label="X"
target="_blank"
rel="noopener"
>
<svg
width="24"
height="24"
viewBox="0 0 24 24"
fill="none"
xmlns="http://www.w3.org/2000/svg"
alt="X"
>
<path
d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"
/>
</svg>
</a>
<a
href="https://www.youtube.com/channel/UCbn1OgGei-DV7aSRo_HaAiw"
aria-label="Youtube"
target="_blank"
rel="noopener"
>
<svg
width="29"
height="20"
viewBox="0 0 29 20"
fill="none"
xmlns="http://www.w3.org/2000/svg"
alt="Youtube"
>
<path
fill-rule="evenodd"
clip-rule="evenodd"
d="M27.4896 1.52422C27.9301 1.96749 28.2463 2.51866 28.4068 3.12258C29.0004 5.35161 29.0004 10 29.0004 10C29.0004 10 29.0004 14.6484 28.4068 16.8774C28.2463 17.4813 27.9301 18.0325 27.4896 18.4758C27.0492 18.9191 26.5 19.2389 25.8972 19.4032C23.6778 20 14.8068 20 14.8068 20C14.8068 20 5.93586 20 3.71651 19.4032C3.11363 19.2389 2.56449 18.9191 2.12405 18.4758C1.68361 18.0325 1.36732 17.4813 1.20683 16.8774C0.613281 14.6484 0.613281 10 0.613281 10C0.613281 10 0.613281 5.35161 1.20683 3.12258C1.36732 2.51866 1.68361 1.96749 2.12405 1.52422C2.56449 1.08095 3.11363 0.76113 3.71651 0.596774C5.93586 0 14.8068 0 14.8068 0C14.8068 0 23.6778 0 25.8972 0.596774C26.5 0.76113 27.0492 1.08095 27.4896 1.52422ZM19.3229 10L11.9036 5.77905V14.221L19.3229 10Z"
/>
</svg>
</a>
</div>
</div>
</div>
</main>
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<!-- * * * * * * * * * * * The content above * * * * * * * * * * * * -->
<!-- * * * * * * * * * * is only a placeholder * * * * * * * * * * * -->
<!-- * * * * * * * * * * and can be replaced. * * * * * * * * * * * -->
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<!-- * * * * * * * * * * End of Placeholder * * * * * * * * * * * * -->
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<app-users-page />
+7 -16
View File
@@ -1,23 +1,14 @@
import { describe, expect, it, vi } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { App } from './app';
describe('App', () => {
beforeEach(async () => {
await TestBed.configureTestingModule({
imports: [App],
}).compileComponents();
});
it('should create the app', () => {
it('renders the users page heading', async () => {
vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ json: () => Promise.resolve([]) }));
await TestBed.configureTestingModule({ imports: [App] }).compileComponents();
const fixture = TestBed.createComponent(App);
const app = fixture.componentInstance;
expect(app).toBeTruthy();
});
it('should render title', async () => {
const fixture = TestBed.createComponent(App);
await fixture.whenStable();
const compiled = fixture.nativeElement as HTMLElement;
expect(compiled.querySelector('h1')?.textContent).toContain('Hello, ng-signals-template');
fixture.detectChanges();
expect(fixture.nativeElement.querySelector('h1')?.textContent).toBe('Users');
vi.unstubAllGlobals();
});
});
+5 -6
View File
@@ -1,11 +1,10 @@
import { Component, signal } from '@angular/core';
import { Component } from '@angular/core';
import { UsersPage } from '@users/ui/users.page';
@Component({
selector: 'app-root',
imports: [],
imports: [UsersPage],
templateUrl: './app.html',
styleUrl: './app.css'
styleUrl: './app.css',
})
export class App {
protected readonly title = signal('ng-signals-template');
}
export class App {}
@@ -0,0 +1,46 @@
import { describe, expect, it } from 'vitest';
import type { Resource } from '@angular/core';
import { fromResource } from './remote-data';
interface FakeResourceOverrides<T> {
status?: () => string;
hasValue?: () => boolean;
value?: () => T;
error?: () => unknown;
}
function fakeResource<T>(overrides: FakeResourceOverrides<T>): Resource<T> {
return {
status: () => 'resolved',
hasValue: () => false,
value: () => undefined as T,
error: () => undefined,
...overrides,
} as unknown as Resource<T>;
}
describe('fromResource', () => {
it('is Loading while the resource has not resolved', () => {
const rd = fromResource(fakeResource<string[]>({ hasValue: () => false }));
expect(rd).toEqual({ tag: 'Loading' });
});
it('is Failure when the resource has errored', () => {
const error = new Error('boom');
const rd = fromResource(fakeResource<string[]>({ status: () => 'error', error: () => error }));
expect(rd).toEqual({ tag: 'Failure', error });
});
it('is Empty when the resolved value is considered empty', () => {
const rd = fromResource(
fakeResource<string[]>({ hasValue: () => true, value: () => [] }),
(v) => v.length === 0,
);
expect(rd).toEqual({ tag: 'Empty' });
});
it('is Success with the value when resolved and not empty', () => {
const rd = fromResource(fakeResource<string[]>({ hasValue: () => true, value: () => ['a'] }));
expect(rd).toEqual({ tag: 'Success', value: ['a'] });
});
});
+24
View File
@@ -0,0 +1,24 @@
import type { Resource } from '@angular/core';
/**
* Four mutually exclusive async states — the data lives ON the state, so e.g.
* "success with no value" or "error with a stale value" is unrepresentable.
*/
export type RemoteData<E, T> =
| { tag: 'Loading' }
| { tag: 'Empty' }
| { tag: 'Failure'; error: E }
| { tag: 'Success'; value: T };
/** Project Angular's own resource() into a RemoteData value. */
export function fromResource<T>(
r: Resource<T>,
isEmpty: (v: T) => boolean = () => false,
): RemoteData<unknown, T> {
if (r.status() === 'error') return { tag: 'Failure', error: r.error() };
if (r.hasValue()) {
const v = r.value();
return isEmpty(v) ? { tag: 'Empty' } : { tag: 'Success', value: v };
}
return { tag: 'Loading' };
}
@@ -0,0 +1,13 @@
import { describe, expect, it } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { SpinnerComponent } from './spinner.component';
describe('SpinnerComponent', () => {
it('renders a status role element', async () => {
await TestBed.configureTestingModule({ imports: [SpinnerComponent] }).compileComponents();
const fixture = TestBed.createComponent(SpinnerComponent);
fixture.detectChanges();
const el = fixture.nativeElement as HTMLElement;
expect(el.querySelector('[role="status"]')).toBeTruthy();
});
});
@@ -0,0 +1,22 @@
import { Component } from '@angular/core';
@Component({
selector: 'app-spinner',
template: `<div class="spinner" role="status" aria-label="Loading"></div>`,
styles: `
.spinner {
width: 1.5rem;
height: 1.5rem;
border: 2px solid #ddd;
border-top-color: #333;
border-radius: 50%;
animation: spin 0.6s linear infinite;
}
@keyframes spin {
to {
transform: rotate(360deg);
}
}
`,
})
export class SpinnerComponent {}
@@ -0,0 +1,60 @@
import { describe, expect, it } from 'vitest';
import { Component } from '@angular/core';
import { TestBed } from '@angular/core/testing';
import { AsyncComponent } from './async.component';
import type { RemoteData } from '@shared/application/remote-data';
@Component({
imports: [AsyncComponent],
template: `
<app-async [data]="data" (retry)="retried = true">
<p class="content">loaded content</p>
</app-async>
`,
})
class HostComponent {
data: RemoteData<unknown, string> = { tag: 'Loading' };
retried = false;
}
function render(data: RemoteData<unknown, string>) {
const fixture = TestBed.createComponent(HostComponent);
fixture.componentInstance.data = data;
fixture.detectChanges();
return fixture;
}
describe('AsyncComponent', () => {
it('shows a spinner while loading', async () => {
await TestBed.configureTestingModule({ imports: [HostComponent] }).compileComponents();
const fixture = render({ tag: 'Loading' });
expect(fixture.nativeElement.querySelector('app-spinner')).toBeTruthy();
});
it('shows the empty text when empty', async () => {
await TestBed.configureTestingModule({ imports: [HostComponent] }).compileComponents();
const fixture = render({ tag: 'Empty' });
expect(fixture.nativeElement.textContent).toContain('No data.');
});
it('shows the error text on failure', async () => {
await TestBed.configureTestingModule({ imports: [HostComponent] }).compileComponents();
const fixture = render({ tag: 'Failure', error: new Error('boom') });
expect(fixture.nativeElement.querySelector('[role="alert"]')?.textContent).toContain(
'Something went wrong.',
);
});
it('emits retry when the retry button is clicked', async () => {
await TestBed.configureTestingModule({ imports: [HostComponent] }).compileComponents();
const fixture = render({ tag: 'Failure', error: new Error('boom') });
fixture.nativeElement.querySelector('button').click();
expect(fixture.componentInstance.retried).toBe(true);
});
it('projects success content when successful', async () => {
await TestBed.configureTestingModule({ imports: [HostComponent] }).compileComponents();
const fixture = render({ tag: 'Success', value: 'x' });
expect(fixture.nativeElement.querySelector('.content')).toBeTruthy();
});
});
@@ -0,0 +1,32 @@
import { Component, input, output } from '@angular/core';
import { SpinnerComponent } from '@shared/ui/atoms/spinner.component';
import type { RemoteData } from '@shared/application/remote-data';
@Component({
selector: 'app-async',
imports: [SpinnerComponent],
template: `
@switch (data().tag) {
@case ('Loading') {
<app-spinner />
}
@case ('Empty') {
<p>{{ emptyText() }}</p>
}
@case ('Failure') {
<p role="alert">{{ errorText() }}</p>
<button type="button" (click)="retry.emit()">{{ retryText() }}</button>
}
@case ('Success') {
<ng-content />
}
}
`,
})
export class AsyncComponent<T> {
data = input.required<RemoteData<unknown, T>>();
emptyText = input('No data.');
errorText = input('Something went wrong.');
retryText = input('Retry');
retry = output<void>();
}
@@ -0,0 +1,13 @@
import { describe, expect, it } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { PageShellComponent } from './page-shell.component';
describe('PageShellComponent', () => {
it('renders the heading', async () => {
await TestBed.configureTestingModule({ imports: [PageShellComponent] }).compileComponents();
const fixture = TestBed.createComponent(PageShellComponent);
fixture.componentRef.setInput('heading', 'Users');
fixture.detectChanges();
expect(fixture.nativeElement.querySelector('h1')?.textContent).toBe('Users');
});
});
@@ -0,0 +1,12 @@
import { Component, input } from '@angular/core';
@Component({
selector: 'app-page-shell',
template: `
<h1>{{ heading() }}</h1>
<ng-content />
`,
})
export class PageShellComponent {
heading = input.required<string>();
}
@@ -0,0 +1,5 @@
import { resource } from '@angular/core';
import { fetchUserById } from '@users/infrastructure/users.adapter';
export const userDetailResource = (userId: () => number) =>
resource({ params: userId, loader: ({ params }) => fetchUserById(params) });
@@ -0,0 +1,4 @@
import { resource } from '@angular/core';
import { fetchUsers } from '@users/infrastructure/users.adapter';
export const usersResource = () => resource({ loader: fetchUsers });
+16
View File
@@ -0,0 +1,16 @@
import { describe, expect, it } from 'vitest';
import { isEmptyUserList } from './user';
describe('isEmptyUserList', () => {
it('is empty for an empty list', () => {
expect(isEmptyUserList([])).toBe(true);
});
it('is not empty when a user is present', () => {
expect(isEmptyUserList([{ id: 1, name: 'Ada' }])).toBe(false);
});
it('is empty when the list is undefined', () => {
expect(isEmptyUserList(undefined)).toBe(true);
});
});
+15
View File
@@ -0,0 +1,15 @@
export interface User {
id: number;
name: string;
}
export interface UserDetail extends User {
email: string;
}
/**
* Accepts `undefined` because a resource's value is `T | undefined` until it resolves
* (no `defaultValue` is set) — `fromResource` only calls this once `hasValue()` is true,
* but the type can't express that across the generic boundary.
*/
export const isEmptyUserList = (users: User[] | undefined): boolean => !users || users.length === 0;
@@ -0,0 +1,7 @@
import type { User, UserDetail } from '@users/domain/user';
export const fetchUsers = (): Promise<User[]> =>
fetch('https://jsonplaceholder.typicode.com/users').then((r) => r.json());
export const fetchUserById = (id: number): Promise<UserDetail> =>
fetch(`https://jsonplaceholder.typicode.com/users/${id}`).then((r) => r.json());
@@ -0,0 +1,42 @@
import { afterEach, describe, expect, it, vi } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { UserDetailComponent } from './user-detail.component';
afterEach(() => {
vi.unstubAllGlobals();
});
describe('UserDetailComponent', () => {
it("shows the fetched user's name and email once resolved", async () => {
vi.stubGlobal(
'fetch',
vi.fn().mockResolvedValue({
json: () => Promise.resolve({ id: 1, name: 'Ada', email: 'ada@example.com' }),
}),
);
await TestBed.configureTestingModule({ imports: [UserDetailComponent] }).compileComponents();
const fixture = TestBed.createComponent(UserDetailComponent);
fixture.componentRef.setInput('userId', 1);
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
expect(fixture.nativeElement.textContent).toContain('ada@example.com');
});
it('emits close when the back button is clicked', async () => {
vi.stubGlobal(
'fetch',
vi.fn().mockResolvedValue({
json: () => Promise.resolve({ id: 1, name: 'Ada', email: 'a@x.com' }),
}),
);
await TestBed.configureTestingModule({ imports: [UserDetailComponent] }).compileComponents();
const fixture = TestBed.createComponent(UserDetailComponent);
fixture.componentRef.setInput('userId', 1);
fixture.detectChanges();
let closed = false;
fixture.componentInstance.close.subscribe(() => (closed = true));
fixture.nativeElement.querySelectorAll('button')[0].click();
expect(closed).toBe(true);
});
});
@@ -0,0 +1,23 @@
import { Component, computed, input, output } from '@angular/core';
import { AsyncComponent } from '@shared/ui/molecules/async.component';
import { fromResource } from '@shared/application/remote-data';
import { userDetailResource } from '@users/application/user-detail.resource';
@Component({
selector: 'app-user-detail',
imports: [AsyncComponent],
template: `
<app-async [data]="data()" (retry)="detailResource.reload()">
@if (detailResource.value(); as u) {
<p>{{ u.name }} — {{ u.email }}</p>
}
</app-async>
<button type="button" (click)="close.emit()">Back</button>
`,
})
export class UserDetailComponent {
userId = input.required<number>();
close = output<void>();
protected detailResource = userDetailResource(() => this.userId());
protected data = computed(() => fromResource(this.detailResource));
}
@@ -0,0 +1,27 @@
import { describe, expect, it } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { UserListComponent } from './user-list.component';
describe('UserListComponent', () => {
it('renders one button per user', async () => {
await TestBed.configureTestingModule({ imports: [UserListComponent] }).compileComponents();
const fixture = TestBed.createComponent(UserListComponent);
fixture.componentRef.setInput('users', [
{ id: 1, name: 'Ada' },
{ id: 2, name: 'Grace' },
]);
fixture.detectChanges();
expect(fixture.nativeElement.querySelectorAll('button').length).toBe(2);
});
it("emits select with the clicked user's id", async () => {
await TestBed.configureTestingModule({ imports: [UserListComponent] }).compileComponents();
const fixture = TestBed.createComponent(UserListComponent);
fixture.componentRef.setInput('users', [{ id: 7, name: 'Ada' }]);
fixture.detectChanges();
let selected: number | undefined;
fixture.componentInstance.select.subscribe((id: number) => (selected = id));
fixture.nativeElement.querySelector('button').click();
expect(selected).toBe(7);
});
});
@@ -0,0 +1,19 @@
import { Component, input, output } from '@angular/core';
import type { User } from '@users/domain/user';
@Component({
selector: 'app-user-list',
template: `
<ul>
@for (u of users(); track u.id) {
<li>
<button type="button" (click)="select.emit(u.id)">{{ u.name }}</button>
</li>
}
</ul>
`,
})
export class UserListComponent {
users = input.required<User[]>();
select = output<number>();
}
+66
View File
@@ -0,0 +1,66 @@
import { afterEach, describe, expect, it, vi } from 'vitest';
import { TestBed } from '@angular/core/testing';
import { UsersPage } from './users.page';
function stubFetch() {
vi.stubGlobal(
'fetch',
vi.fn((url: string) => {
if (url.endsWith('/users')) {
return Promise.resolve({ json: () => Promise.resolve([{ id: 1, name: 'Ada' }]) });
}
return Promise.resolve({
json: () => Promise.resolve({ id: 1, name: 'Ada', email: 'ada@example.com' }),
});
}),
);
}
afterEach(() => {
vi.unstubAllGlobals();
});
describe('UsersPage', () => {
it('renders the fetched users as a list', async () => {
stubFetch();
await TestBed.configureTestingModule({ imports: [UsersPage] }).compileComponents();
const fixture = TestBed.createComponent(UsersPage);
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
expect(fixture.nativeElement.textContent).toContain('Ada');
});
it("shows a user's details after clicking their name", async () => {
stubFetch();
await TestBed.configureTestingModule({ imports: [UsersPage] }).compileComponents();
const fixture = TestBed.createComponent(UsersPage);
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
fixture.nativeElement.querySelector('button').click();
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
expect(fixture.nativeElement.textContent).toContain('ada@example.com');
});
it('returns to the list when the detail view is closed', async () => {
stubFetch();
await TestBed.configureTestingModule({ imports: [UsersPage] }).compileComponents();
const fixture = TestBed.createComponent(UsersPage);
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
fixture.nativeElement.querySelector('button').click();
fixture.detectChanges();
await fixture.whenStable();
fixture.detectChanges();
const backButton = Array.from(fixture.nativeElement.querySelectorAll('button')).find(
(b) => (b as HTMLElement).textContent === 'Back',
) as HTMLElement;
backButton.click();
fixture.detectChanges();
expect(fixture.nativeElement.querySelector('app-user-detail')).toBeFalsy();
});
});
+31
View File
@@ -0,0 +1,31 @@
import { Component, computed, signal } from '@angular/core';
import { PageShellComponent } from '@shared/ui/templates/page-shell.component';
import { AsyncComponent } from '@shared/ui/molecules/async.component';
import { fromResource } from '@shared/application/remote-data';
import { UserListComponent } from '@users/ui/organisms/user-list.component';
import { UserDetailComponent } from '@users/ui/organisms/user-detail.component';
import { usersResource } from '@users/application/users.resource';
import { isEmptyUserList } from '@users/domain/user';
@Component({
selector: 'app-users-page',
imports: [PageShellComponent, AsyncComponent, UserListComponent, UserDetailComponent],
template: `
<app-page-shell heading="Users">
@if (selectedUserId(); as id) {
<app-user-detail [userId]="id" (close)="selectedUserId.set(null)" />
} @else {
<app-async [data]="listData()" (retry)="usersResource.reload()">
@if (usersResource.hasValue()) {
<app-user-list [users]="usersResource.value()!" (select)="selectedUserId.set($event)" />
}
</app-async>
}
</app-page-shell>
`,
})
export class UsersPage {
protected selectedUserId = signal<number | null>(null);
protected usersResource = usersResource();
protected listData = computed(() => fromResource(this.usersResource, isEmptyUserList));
}
+1 -2
View File
@@ -2,5 +2,4 @@ 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));
bootstrapApplication(App, appConfig).catch((err) => console.error(err));
+7 -1
View File
@@ -12,7 +12,13 @@
"experimentalDecorators": true,
"importHelpers": true,
"target": "ES2022",
"module": "preserve"
"module": "preserve",
"ignoreDeprecations": "6.0",
"baseUrl": ".",
"paths": {
"@shared/*": ["src/app/shared/*"],
"@users/*": ["src/app/users/*"]
}
},
"angularCompilerOptions": {
"enableI18nLegacyMessageIdFormat": false,