@kksdev/ds-angular 1.10.0 → 1.12.0

package/README.md

@@ -1,63 +1,66 @@
-# DsAngular
+# @kksdev/ds-angular
 
-This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 19.2.0.
+Angular 20 Design System - Bibliothèque de composants standalone avec signals.
 
-## Code scaffolding
+## Features
 
-Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+- 55 composants UI (Button, Modal, Table, Form, etc.)
+- 7 primitives (Button, Input, Checkbox, Radio, Textarea, Toggle, Badge)
+- 3 thèmes (Light, Dark, Custom)
+- Support i18n
+- Accessible (WCAG 2.1 AA)
+- Standalone components avec signals
 
-```bash
-ng generate component component-name
-```
-
-For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+## Installation
 
 ```bash
-ng generate --help
+npm install @kksdev/ds-angular
 ```
 
-## Building
-
-To build the library, run:
+## Peer Dependencies
 
 ```bash
-ng build ds-angular
+npm install @angular/cdk @fortawesome/angular-fontawesome @fortawesome/fontawesome-svg-core @fortawesome/free-solid-svg-icons
 ```
 
-This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+## Usage
 
-### Publishing the Library
+```typescript
+import { DsButton, DsModal, DsInputField } from '@kksdev/ds-angular';
 
-Once the project is built, you can publish your library by following these steps:
+@Component({
+  imports: [DsButton, DsModal, DsInputField],
+  template: `
+    <ds-button variant="primary" (clicked)="onSave()">
+      Enregistrer
+    </ds-button>
+  `
+})
+export class MyComponent {}
+```
 
-1. Navigate to the `dist` directory:
-   ```bash
-   cd dist/ds-angular
-   ```
+## Thèmes
 
-2. Run the `npm publish` command to publish your library to the npm registry:
-   ```bash
-   npm publish
-   ```
+Activez un thème en ajoutant la classe sur le document :
 
-## Running unit tests
+```typescript
+document.documentElement.className = 'theme-light'; // ou 'theme-dark', 'theme-custom'
+```
 
-To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+## Documentation
 
-```bash
-ng test
-```
+Documentation complète et démos interactives :
 
-## Running end-to-end tests
+**https://ds-showcase.kkshome.online/**
 
-For end-to-end (e2e) testing, run:
+## Composants disponibles
 
-```bash
-ng e2e
-```
+### Primitives
+`PrimitiveButton` `PrimitiveInput` `PrimitiveCheckbox` `PrimitiveRadio` `PrimitiveTextarea` `PrimitiveToggle` `PrimitiveBadge`
 
-Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+### Composants
+`DsButton` `DsModal` `DsTable` `DsInputField` `DsSelect` `DsCheckbox` `DsRadio` `DsTextarea` `DsToggle` `DsAlert` `DsToast` `DsBadge` `DsCard` `DsTabs` `DsAccordion` `DsDropdown` `DsTooltip` `DsPopover` `DsProgress` `DsSpinner` `DsSkeleton` `DsAvatar` `DsBreadcrumb` `DsPagination` `DsDatePicker` `DsTimePicker` `DsSlider` `DsRating` `DsFileUpload` `DsAutocomplete` ...et plus
 
-## Additional Resources
+## License
 
-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.
+MIT