new-component
按照项目约定使用测试文件搭建一个新的 Angular 组件。在创建新组件、小部件或 UI 元素时使用。
📖 中文导读:按照项目约定使用测试文件搭建一个新的 Angular 组件。在创建新组件、小部件或 UI 元素时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: new-component description: Scaffold a new Angular component with test file following project conventions. Use when creating new components, widgets, or UI elements.
New Component Skill
Generate Angular standalone components following hnews project patterns.
File Structure
Create two files:
src/app/components/{component-name}/{component-name}.component.tssrc/app/components/{component-name}/{component-name}.component.spec.ts
For shared/reusable widgets, use src/app/components/shared/{component-name}/.
Component Template
// SPDX-License-Identifier: MIT
// Copyright (C) 2025 Alysson Souza
import { Component, ChangeDetectionStrategy, input, output } from '@angular/core';
@Component({
selector: 'app-{component-name}',
changeDetection: ChangeDetectionStrategy.OnPush,
imports: [],
template: `
<!-- Template here -->
`,
styles: [
`
@reference '../../../styles.css';
:host {
@apply contents;
}
`,
],
})
export class {ComponentName}Component {
// Use signal-based inputs/outputs
readonly someInput = input<string>('');
readonly someOutput = output<void>();
}
Test Template
// SPDX-License-Identifier: MIT
// Copyright (C) 2025 Alysson Souza
import { ComponentFixture, TestBed } from '@angular/core/testing';
import { {ComponentName}Component } from './{component-name}.component';
describe('{ComponentName}Component', () => {
let component: {ComponentName}Component;
let fixture: ComponentFixture<{ComponentName}Component>;
beforeEach(async () => {
await TestBed.configureTestingModule({
imports: [{ComponentName}Component],
}).compileComponents();
fixture = TestBed.createComponent({ComponentName}Component);
component = fixture.componentInstance;
fixture.detectChanges();
});
it('should create', () => {
expect(component).toBeTruthy();
});
// Set inputs using fixture.componentRef.setInput('inputName', value)
});
Key Conventions
- No
standalone: true— It's the default in Angular 20+ - Use
ChangeDetectionStrategy.OnPushalways - Signal-based APIs: Use
input(),output(),viewChild()instead of decorators - Styles reference: Use
@reference '../../../styles.css';(adjust path depth) - Tailwind: Use
@applyfor component styles - Dark mode: Include
.dark:variants for colors - Selector prefix: Always
app-(kebab-case) - Class suffix:
{Name}Component
After Creation
Run ng test --include src/app/components/{component-name}/{component-name}.component.spec.ts to verify.