angular-tailwind-components 1.3.1 → 1.4.0

package/README.md

@@ -35,8 +35,6 @@ The same import also pulls in:
 @import 'tailwindcss';
 ```
 
-Or define your own theme tokens following the design system schema.
-
 ## Quick Start
 
 ```typescript
@@ -64,6 +62,34 @@ export class ExampleComponent {
 }
 ```
 
+## Application configuration
+
+Register shared defaults for library injection tokens with **`provideTailwindComponents`**. Each property is optional; only set keys produce `Provider` entries (same effect as individual `{ provide: TAILWIND_…, useValue: … }`). The function returns **`EnvironmentProviders`** (`makeEnvironmentProviders`), so you add it as **one** entry in `providers` without the spread operator.
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { provideTailwindComponents } from 'angular-tailwind-components';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideTailwindComponents({
+      iconSize: 20,
+      datetimeLanguage: 'it',
+      componentsSize: 'md',
+      paginationSummary: 'Visualizzati {start}-{end} di {total}'
+    })
+  ]
+};
+```
+
+| Config key | Token |
+| --- | --- |
+| `iconSize` | `TAILWIND_ICON_SIZE` |
+| `datetimeLanguage` | `TAILWIND_DATETIME_LANGUAGE` |
+| `componentsSize` | `TAILWIND_COMPONENTS_SIZE` |
+| `paginationSummary` | `TAILWIND_PAGINATION_SUMMARY` |
+| `modalData` | `TAILWIND_MODAL_DATA` (rare at app scope; modal `open()` still supplies per-dialog data) |
+
 ## Content slots
 
 Some components (for example `tailwind-card`, `tailwind-modal`, `tailwind-toolbar`, `tailwind-drawer`, `tailwind-notification`) support **named slots** via **attribute selectors** on native elements, matching `ng-content select="[…]"` in the library. Example: `<div tailwind-card-header>…</div>`, `<div tailwind-modal-content>…</div>`. Optional helper components for modal (`TailwindModalTitle`, and so on) use the same attribute on the host.
@@ -91,7 +117,7 @@ Some components (for example `tailwind-card`, `tailwind-modal`, `tailwind-toolba
 - **Card** (`tailwind-card`): Content card with header/body/footer
 - **Chip** (`tailwind-chip`): Removable tags
 - **Tag** (`tailwind-tag`): Semantic labels
-- **Title** (`tailwind-title`): Semantic headings (`h1`–`h6`) with required `text` and optional Solar Line Duotone icon
+- **Title** (`tailwind-title`): Semantic headings (`h1`–`h6`) with required `text` and optional Heroicons outline icon
 
 ### Feedback
 
@@ -164,4 +190,4 @@ npm run storybook
 
 MIT
 
-The bundled **Solar Line Duotone** SVG icons are © [480 Design](https://www.figma.com/@480design) / [Solar Icons](https://solar-icons.vercel.app/icons), licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+The bundled **[Heroicons](https://heroicons.com/)** outline SVG icons are © [Tailwind Labs](https://tailwindcss.com/), licensed under the [MIT License](https://github.com/tailwindlabs/heroicons/blob/master/LICENSE).