My Library

Nowoczesna biblioteka komponentów dla aplikacji Angular 20.

🚀 Instalacja

npm install my-library

📖 Użycie

Import komponentów

import { Button } from 'my-library';

@Component({
  selector: 'app-root',
  imports: [Button],
  template: '<lib-button>Click me</lib-button>'
})
export class AppComponent {}

Import serwisów

import { Data } from 'my-library';

@Component({
  selector: 'app-root'
})
export class AppComponent {
  constructor(private dataService: Data) {}
}

📦 Dostępne komponenty

Button

Komponent przycisku z rozszerzonymi możliwościami stylowania.

Inputs:

• type: 'button' | 'submit' | 'reset' - typ przycisku (domyślnie: 'button')
• variant: 'primary' | 'secondary' | 'danger' - wariant stylistyczny (domyślnie: 'primary')
• disabled: boolean - stan nieaktywny (domyślnie: false)

Outputs:

• clicked: EventEmitter<void> - event emitowany przy kliknięciu

Przykład:

<lib-button 
  type="submit" 
  variant="primary"
  (clicked)="handleClick()">
  Submit
</lib-button>

🛠️ Dostępne serwisy

DataService

Serwis do zarządzania danymi aplikacji używający signals.

Metody:

• addItem(item: DataItem): void - dodaje nowy element
• removeItem(id: number): void - usuwa element po ID
• getItem(id: number): DataItem | undefined - pobiera element po ID
• clearAll(): void - czyści wszystkie elementy
• data: Signal<DataItem[]> - readonly signal z danymi

🏗️ Building

Aby zbudować bibliotekę, uruchom:

ng build my-library

Skompilowane pliki znajdą się w katalogu dist/my-library/.

📤 Publikacja do Nexus

Konfiguracja

1. Upewnij się, że plik .npmrc zawiera poprawną konfigurację Nexus:

   registry=https://your-nexus-url/repository/npm-group/
   //your-nexus-url/repository/npm-hosted/:_authToken=${NPM_TOKEN}

2. Ustaw zmienną środowiskową z tokenem:

   # Windows PowerShell
   $env:NPM_TOKEN="your-token-here"
      
   # Linux/Mac
   export NPM_TOKEN="your-token-here"

Publikacja

1. Zbuduj bibliotekę:

   ng build my-library

2. Przejdź do katalogu dist:

   cd dist/my-library

3. Opublikuj do Nexus:

   npm publish --registry=https://your-nexus-url/repository/npm-hosted/

🧪 Testy

Aby uruchomić testy jednostkowe:

ng test my-library

📚 Dokumentacja

Szczegółowa dokumentacja dostępna jest w aplikacji dokumentacyjnej. Aby ją uruchomić:

npm start

Aplikacja będzie dostępna pod adresem http://localhost:4200.

🤝 Współpraca

Zgłoszenia błędów i pull requesty są mile widziane!

📄 Licencja

MIT

🔗 Dodatkowe zasoby

• Angular CLI Documentation
• Angular 20 Documentation