@egose/shadcn-theme-ng 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/README.md +2 -2
  2. package/accordion/README.md +405 -2
  3. package/alert/README.md +372 -2
  4. package/alert-dialog/README.md +471 -5
  5. package/aspect-ratio/README.md +272 -5
  6. package/autocomplete/README.md +502 -2
  7. package/autocomplete/fesm2022/autocomplete.mjs +1 -1
  8. package/avatar/README.md +357 -5
  9. package/badge/README.md +318 -2
  10. package/basic-alert/README.md +353 -2
  11. package/breadcrumb/README.md +406 -5
  12. package/button/README.md +482 -2
  13. package/button/fesm2022/button.mjs +85 -107
  14. package/button/types/button.d.ts +5 -8
  15. package/button-group/README.md +318 -5
  16. package/calendar/README.md +357 -2
  17. package/card/README.md +331 -5
  18. package/carousel/README.md +333 -5
  19. package/carousel/fesm2022/carousel.mjs +4 -1
  20. package/checkbox/README.md +320 -2
  21. package/checkbox/fesm2022/checkbox.mjs +6 -7
  22. package/checkbox/types/checkbox.d.ts +1 -1
  23. package/collapsible/README.md +332 -5
  24. package/combobox/README.md +507 -5
  25. package/combobox/fesm2022/combobox.mjs +5 -2
  26. package/command/README.md +435 -5
  27. package/confirmation-dialog/README.md +301 -2
  28. package/context-menu/README.md +366 -5
  29. package/date-picker/README.md +469 -2
  30. package/date-picker/fesm2022/date-picker.mjs +150 -32
  31. package/date-picker/types/date-picker.d.ts +102 -9
  32. package/dialog/README.md +448 -2
  33. package/drawer/README.md +395 -5
  34. package/dropdown-menu/README.md +417 -5
  35. package/empty/README.md +329 -5
  36. package/field/README.md +385 -5
  37. package/form-autocomplete/README.md +177 -0
  38. package/form-autocomplete/fesm2022/form-autocomplete.mjs +125 -0
  39. package/form-autocomplete/package.json +24 -0
  40. package/form-autocomplete/types/form-autocomplete.d.ts +61 -0
  41. package/form-checkbox/README.md +322 -2
  42. package/form-checkbox/fesm2022/form-checkbox.mjs +22 -9
  43. package/form-checkbox/types/form-checkbox.d.ts +23 -4
  44. package/form-combobox/README.md +202 -0
  45. package/form-combobox/fesm2022/form-combobox.mjs +147 -0
  46. package/form-combobox/package.json +24 -0
  47. package/form-combobox/types/form-combobox.d.ts +73 -0
  48. package/form-date-picker/README.md +348 -2
  49. package/form-date-picker/fesm2022/form-date-picker.mjs +38 -12
  50. package/form-date-picker/types/form-date-picker.d.ts +17 -1
  51. package/form-date-picker-multi/README.md +191 -0
  52. package/form-date-picker-multi/fesm2022/form-date-picker-multi.mjs +129 -0
  53. package/form-date-picker-multi/package.json +24 -0
  54. package/form-date-picker-multi/types/form-date-picker-multi.d.ts +58 -0
  55. package/form-date-range-picker/README.md +253 -0
  56. package/form-date-range-picker/fesm2022/form-date-range-picker.mjs +130 -0
  57. package/form-date-range-picker/package.json +24 -0
  58. package/form-date-range-picker/types/form-date-range-picker.d.ts +55 -0
  59. package/form-field/README.md +356 -2
  60. package/form-field-simple/README.md +340 -2
  61. package/form-input-otp/README.md +194 -0
  62. package/form-input-otp/fesm2022/form-input-otp.mjs +106 -0
  63. package/form-input-otp/package.json +24 -0
  64. package/form-input-otp/types/form-input-otp.d.ts +58 -0
  65. package/form-month-year-picker/README.md +188 -0
  66. package/form-month-year-picker/fesm2022/form-month-year-picker.mjs +125 -0
  67. package/form-month-year-picker/package.json +24 -0
  68. package/form-month-year-picker/types/form-month-year-picker.d.ts +53 -0
  69. package/form-native-select/README.md +205 -0
  70. package/form-native-select/fesm2022/form-native-select.mjs +103 -0
  71. package/form-native-select/package.json +24 -0
  72. package/form-native-select/types/form-native-select.d.ts +57 -0
  73. package/form-phone-input/README.md +188 -0
  74. package/form-phone-input/fesm2022/form-phone-input.mjs +113 -0
  75. package/form-phone-input/package.json +24 -0
  76. package/form-phone-input/types/form-phone-input.d.ts +58 -0
  77. package/form-radio-group/README.md +198 -0
  78. package/form-radio-group/fesm2022/form-radio-group.mjs +111 -0
  79. package/form-radio-group/package.json +24 -0
  80. package/form-radio-group/types/form-radio-group.d.ts +63 -0
  81. package/form-searchable-multiselect/README.md +371 -2
  82. package/form-searchable-multiselect/fesm2022/form-searchable-multiselect.mjs +19 -10
  83. package/form-searchable-multiselect/types/form-searchable-multiselect.d.ts +18 -1
  84. package/form-select/README.md +360 -2
  85. package/form-select/fesm2022/form-select.mjs +20 -11
  86. package/form-select/types/form-select.d.ts +18 -1
  87. package/form-slider/README.md +182 -0
  88. package/form-slider/fesm2022/form-slider.mjs +106 -0
  89. package/form-slider/package.json +24 -0
  90. package/form-slider/types/form-slider.d.ts +60 -0
  91. package/form-switch/README.md +173 -0
  92. package/form-switch/fesm2022/form-switch.mjs +100 -0
  93. package/form-switch/package.json +24 -0
  94. package/form-switch/types/form-switch.d.ts +50 -0
  95. package/form-text-input/README.md +381 -2
  96. package/form-text-input/fesm2022/form-text-input.mjs +19 -10
  97. package/form-text-input/types/form-text-input.d.ts +18 -1
  98. package/form-textarea/README.md +357 -2
  99. package/form-textarea/fesm2022/form-textarea.mjs +19 -10
  100. package/form-textarea/types/form-textarea.d.ts +18 -1
  101. package/form-toggle/README.md +186 -0
  102. package/form-toggle/fesm2022/form-toggle.mjs +159 -0
  103. package/form-toggle/package.json +24 -0
  104. package/form-toggle/types/form-toggle.d.ts +82 -0
  105. package/form-toggle-group/README.md +176 -0
  106. package/form-toggle-group/fesm2022/form-toggle-group.mjs +116 -0
  107. package/form-toggle-group/package.json +24 -0
  108. package/form-toggle-group/types/form-toggle-group.d.ts +65 -0
  109. package/hover-card/README.md +256 -5
  110. package/icon/README.md +239 -2
  111. package/input/README.md +269 -2
  112. package/input-group/README.md +335 -5
  113. package/input-group/fesm2022/input-group.mjs +22 -12
  114. package/input-group/types/input-group.d.ts +4 -1
  115. package/input-otp/README.md +375 -5
  116. package/item/README.md +385 -5
  117. package/item/fesm2022/item.mjs +3 -3
  118. package/kbd/README.md +291 -5
  119. package/label/README.md +272 -2
  120. package/layout-simple/README.md +193 -2
  121. package/layout-simple/fesm2022/layout-simple.mjs +472 -236
  122. package/layout-simple/types/layout-simple.d.ts +174 -137
  123. package/menu/README.md +417 -2
  124. package/menubar/README.md +343 -5
  125. package/native-select/README.md +323 -5
  126. package/native-select/fesm2022/native-select.mjs +18 -6
  127. package/native-select/types/native-select.d.ts +7 -2
  128. package/navigation-menu/README.md +369 -5
  129. package/package.json +57 -1
  130. package/pagination/README.md +388 -5
  131. package/phone-input/README.md +114 -0
  132. package/phone-input/fesm2022/phone-input.mjs +191 -0
  133. package/phone-input/package.json +24 -0
  134. package/phone-input/types/phone-input.d.ts +67 -0
  135. package/popover/README.md +331 -2
  136. package/progress/README.md +311 -5
  137. package/radio-group/README.md +364 -2
  138. package/radio-group/fesm2022/radio-group.mjs +5 -1
  139. package/resizable/README.md +269 -5
  140. package/scroll-area/README.md +233 -5
  141. package/searchable-multiselect/README.md +323 -2
  142. package/select/README.md +437 -2
  143. package/separator/README.md +222 -2
  144. package/sheet/README.md +311 -2
  145. package/sidebar/README.md +457 -5
  146. package/skeleton/README.md +217 -5
  147. package/slider/README.md +273 -5
  148. package/slider/fesm2022/slider.mjs +3 -3
  149. package/sonner/README.md +346 -2
  150. package/spinner/README.md +284 -2
  151. package/switch/README.md +310 -2
  152. package/switch/fesm2022/switch.mjs +7 -5
  153. package/switch/types/switch.d.ts +2 -1
  154. package/table/README.md +423 -5
  155. package/tabs/README.md +411 -2
  156. package/tabs/fesm2022/tabs.mjs +2 -2
  157. package/textarea/README.md +282 -5
  158. package/toggle/README.md +270 -5
  159. package/toggle-group/README.md +340 -5
  160. package/tooltip/README.md +269 -2
  161. package/typography/README.md +271 -5
  162. package/utils/README.md +303 -2
@@ -1,11 +1,341 @@
1
- # InputGroup
1
+ # Input Group (`@egose/shadcn-theme-ng/input-group`)
2
2
 
3
- This project was generated using [Angular CLI](https://github.com/angular/angular-cli).
3
+ The input group joins an input (or textarea) with prefixes, suffixes, and inline action buttons into a single bordered control — the shadcn/ui _InputGroup_ equivalent (currency prefix + amount + Apply, URL slug builder, message composer with block add-ons). The outer directive owns the border/focus ring; the inner pieces are borderless so the group reads as one field.
4
4
 
5
- ## Building
5
+ > **Ships as:** `@egose/shadcn-theme-ng/input-group` (plain Tailwind) and `@egose/shadcn-theme-ng-tw/input-group` (`tw:`-prefixed variant). See the [package README](../../README.md) for installation, peer dependencies, and the Tailwind-variant contract. Do not publish this project directory independently.
6
6
 
7
- To build the library, run:
7
+ ## Installation
8
8
 
9
9
  ```bash
10
- ng build input-group
10
+ # Plain Tailwind (no prefix)
11
+ npm install @egose/shadcn-theme-ng
12
+
13
+ # Or the tw:-prefixed variant
14
+ npm install @egose/shadcn-theme-ng-tw
15
+ ```
16
+
17
+ Peer dependencies (Angular, CDK, `@spartan-ng/brain`, `rxjs`) are documented in the [package README](../../README.md#peer-dependencies).
18
+
19
+ ```ts
20
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
21
+ // tw variant:
22
+ // import { HlmInputGroupImports } from '@egose/shadcn-theme-ng-tw/input-group';
23
+ ```
24
+
25
+ ## Imports
26
+
27
+ ```ts
28
+ // Standalone component — spread the imports array:
29
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
30
+
31
+ @Component({
32
+ standalone: true,
33
+ imports: [HlmInputGroupImports],
34
+ template: `
35
+ <div hlmInputGroup>
36
+ <span hlmInputGroupText>$</span>
37
+ <input hlmInputGroupInput placeholder="0.00" aria-label="Amount in dollars" />
38
+ </div>
39
+ `,
40
+ })
41
+ export class MyComp {}
42
+ ```
43
+
44
+ ```ts
45
+ // NgModule-based — import the module:
46
+ import { HlmInputGroupModule } from '@egose/shadcn-theme-ng/input-group';
47
+
48
+ @NgModule({ imports: [HlmInputGroupModule] })
49
+ export class MyModule {}
50
+ ```
51
+
52
+ Exported from `src/public-api.ts`: `HlmInputGroup`, `HlmInputGroupAddon`, `HlmInputGroupButton`, `HlmInputGroupInput`, `HlmInputGroupText`, `HlmInputGroupTextarea`, plus `HlmInputGroupImports` and `HlmInputGroupModule`.
53
+
54
+ ## Anatomy / Structure
55
+
56
+ ```html
57
+ <div hlmInputGroup>
58
+ <!-- inline prefix -->
59
+ <span hlmInputGroupText>$</span>
60
+
61
+ <!-- the actual control (borderless, flex-1) -->
62
+ <input hlmInputGroupInput placeholder="Monthly budget" aria-label="Monthly budget" />
63
+
64
+ <!-- inline action -->
65
+ <button hlmInputGroupButton type="button">Apply</button>
66
+ </div>
67
+
68
+ <!-- block layout for composers -->
69
+ <div hlmInputGroup>
70
+ <div hlmInputGroupAddon align="block-start">Message to #general</div>
71
+ <textarea hlmInputGroupTextarea rows="3" aria-label="Message"></textarea>
72
+ <div hlmInputGroupAddon align="block-end">…</div>
73
+ </div>
11
74
  ```
75
+
76
+ Real selectors: `[hlmInputGroup]` / `hlm-input-group` (container, `role="group"`); `input[hlmInputGroupInput]` (input, `hostDirectives: [HlmInput]`, `data-slot="input-group-control"`); `textarea[hlmInputGroupTextarea]` (`hostDirectives: [HlmTextarea]`, same control slot); `[hlmInputGroupAddon]` / `hlm-input-group-addon` (alignable addon, `align` = `inline-start` | `inline-end` | `block-start` | `block-end`, default `inline-start`); `[hlmInputGroupText]` / `hlm-input-group-text` (plain inline text); `button[hlmInputGroupButton]` (action button, ghost variant preset, `hostDirectives: [HlmBtn]`).
77
+
78
+ ## API reference
79
+
80
+ ### `[hlmInputGroup]` — `HlmInputGroup`
81
+
82
+ Container. No inputs/outputs. `role="group"`, `data-slot="input-group"`. Carries the border, `h-9` height, shadow, and the `:focus-visible` / invalid ring logic that reacts to the inner `[data-slot=input-group-control]` and disabled state (`group-data-[disabled=true]/input-group` dims addons).
83
+
84
+ ### `input[hlmInputGroupInput]` — `HlmInputGroupInput`
85
+
86
+ Borderless input (`hostDirectives: [HlmInput]`). No inputs of its own — all native input attributes and `HlmInput` inputs (`ariaDescribedby`, `id`, `forceInvalid`) apply directly on the element.
87
+
88
+ ### `textarea[hlmInputGroupTextarea]` — `HlmInputGroupTextarea`
89
+
90
+ Borderless textarea (`hostDirectives: [HlmTextarea]`, `resize-none`). No inputs of its own; native textarea attributes apply directly.
91
+
92
+ ### `[hlmInputGroupAddon]` — `HlmInputGroupAddon`
93
+
94
+ | Input | Type | Default | Description |
95
+ | ------- | ---------------------------------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------- |
96
+ | `align` | `'inline-start' \| 'inline-end' \| 'block-start' \| 'block-end'` | `'inline-start'` | Placement: inline prefixes/suffixes vs full-width block rows (reflected as `data-align`). |
97
+
98
+ Inline addons order themselves first/last automatically; block addons stack the group vertically (`flex-col`).
99
+
100
+ ### `[hlmInputGroupText]` — `HlmInputGroupText`
101
+
102
+ Static inline text (currency symbols, units, URL fragments). No inputs/outputs.
103
+
104
+ ### `button[hlmInputGroupButton]` — `HlmInputGroupButton`
105
+
106
+ | Input | Type | Default | Description |
107
+ | --------- | ---------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------- |
108
+ | `size` | `'xs' \| 'sm' \| 'icon-xs' \| 'icon-sm'` | `'xs'` | Button density; `icon-*` variants are square for glyph-only buttons (reflected as `data-size`). |
109
+ | `variant` | (via `HlmBtn`) | `'ghost'` | Forwarded to `HlmBtn`; the group presets the brain button config to `ghost`. |
110
+ | `type` | `'button' \| 'submit' \| 'reset'` | `'button'` | Native button type (bound as `[type]`). |
111
+
112
+ ## Examples
113
+
114
+ ### 1. Currency prefix + action button
115
+
116
+ ```ts
117
+ import { Component, signal } from '@angular/core';
118
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
119
+
120
+ @Component({
121
+ standalone: true,
122
+ imports: [HlmInputGroupImports],
123
+ template: `
124
+ <div hlmInputGroup>
125
+ <span hlmInputGroupText>$</span>
126
+ <input hlmInputGroupInput type="number" placeholder="Monthly budget" aria-label="Monthly budget" />
127
+ <button hlmInputGroupButton type="button" (click)="apply()">Apply</button>
128
+ </div>
129
+ @if (message()) {
130
+ <p role="status" class="tw:mt-2 tw:text-sm">{{ message() }}</p>
131
+ }
132
+ `,
133
+ })
134
+ export class CurrencyExample {
135
+ readonly message = signal<string | null>(null);
136
+
137
+ apply() {
138
+ this.message.set('Budget applied.');
139
+ }
140
+ }
141
+ ```
142
+
143
+ ### 2. URL slug builder (prefix + input + suffix)
144
+
145
+ ```ts
146
+ import { Component } from '@angular/core';
147
+ import { FormsModule } from '@angular/forms';
148
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
149
+
150
+ @Component({
151
+ standalone: true,
152
+ imports: [FormsModule, HlmInputGroupImports],
153
+ template: `
154
+ <div hlmInputGroup>
155
+ <span hlmInputGroupText>https://egose.dev/</span>
156
+ <input
157
+ hlmInputGroupInput
158
+ [(ngModel)]="slug"
159
+ name="slug"
160
+ placeholder="campaign-spring"
161
+ aria-label="Campaign slug"
162
+ />
163
+ <span hlmInputGroupText>.html</span>
164
+ </div>
165
+ <p class="tw:mt-2 tw:text-sm tw:text-slate-500">Preview: https://egose.dev/{{ slug || '…' }}.html</p>
166
+ `,
167
+ })
168
+ export class SlugExample {
169
+ slug = 'angular-standard';
170
+ }
171
+ ```
172
+
173
+ ### 3. Search with icon addon + keyboard shortcut hint
174
+
175
+ ```ts
176
+ import { Component } from '@angular/core';
177
+ import { NgIcon, provideIcons } from '@ng-icons/core';
178
+ import { lucideSearch } from '@ng-icons/lucide';
179
+ import { HlmIcon } from '@egose/shadcn-theme-ng/icon';
180
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
181
+ import { HlmKbd } from '@egose/shadcn-theme-ng/kbd';
182
+
183
+ @Component({
184
+ standalone: true,
185
+ imports: [NgIcon, HlmIcon, HlmInputGroupImports, HlmKbd],
186
+ providers: [provideIcons({ lucideSearch })],
187
+ template: `
188
+ <div hlmInputGroup>
189
+ <span hlmInputGroupText><ng-icon hlm name="lucideSearch" size="sm" /></span>
190
+ <input hlmInputGroupInput placeholder="Search docs…" aria-label="Search docs" />
191
+ <div hlmInputGroupAddon align="inline-end"><kbd hlmKbd>⌘K</kbd></div>
192
+ </div>
193
+ `,
194
+ })
195
+ export class SearchExample {}
196
+ ```
197
+
198
+ ### 4. Icon-only buttons (`icon-xs` / `icon-sm`)
199
+
200
+ ```ts
201
+ import { Component, signal } from '@angular/core';
202
+ import { NgIcon, provideIcons } from '@ng-icons/core';
203
+ import { lucideCopy, lucideCheck } from '@ng-icons/lucide';
204
+ import { HlmIcon } from '@egose/shadcn-theme-ng/icon';
205
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
206
+
207
+ @Component({
208
+ standalone: true,
209
+ imports: [NgIcon, HlmIcon, HlmInputGroupImports],
210
+ providers: [provideIcons({ lucideCopy, lucideCheck })],
211
+ template: `
212
+ <div hlmInputGroup>
213
+ <input hlmInputGroupInput [value]="token()" readonly aria-label="API token" />
214
+ <button
215
+ hlmInputGroupButton
216
+ size="icon-xs"
217
+ type="button"
218
+ (click)="copy()"
219
+ [attr.aria-label]="copied() ? 'Copied' : 'Copy token'"
220
+ >
221
+ <ng-icon hlm [name]="copied() ? 'lucideCheck' : 'lucideCopy'" size="sm" />
222
+ </button>
223
+ </div>
224
+ `,
225
+ })
226
+ export class CopyExample {
227
+ readonly token = signal('sk-live-abc123');
228
+ readonly copied = signal(false);
229
+
230
+ async copy() {
231
+ await navigator.clipboard.writeText(this.token());
232
+ this.copied.set(true);
233
+ setTimeout(() => this.copied.set(false), 1500);
234
+ }
235
+ }
236
+ ```
237
+
238
+ ### 5. Block composer (textarea + block addons)
239
+
240
+ ```ts
241
+ import { Component, signal } from '@angular/core';
242
+ import { FormsModule } from '@angular/forms';
243
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
244
+
245
+ @Component({
246
+ standalone: true,
247
+ imports: [FormsModule, HlmInputGroupImports],
248
+ template: `
249
+ <div hlmInputGroup>
250
+ <div hlmInputGroupAddon align="block-start">Message to #design-review</div>
251
+ <textarea
252
+ hlmInputGroupTextarea
253
+ rows="4"
254
+ [(ngModel)]="draft"
255
+ name="draft"
256
+ aria-label="Message to the design-review channel"
257
+ placeholder="Describe the behavior you want to change…"
258
+ ></textarea>
259
+ <div hlmInputGroupAddon align="block-end" class="tw:flex tw:items-center tw:justify-between">
260
+ <span role="status">{{ status() }}</span>
261
+ <button hlmInputGroupButton type="button" (click)="send()">Send</button>
262
+ </div>
263
+ </div>
264
+ `,
265
+ })
266
+ export class ComposerExample {
267
+ draft = '';
268
+ readonly status = signal('Draft autosaved just now');
269
+
270
+ send() {
271
+ this.status.set('Message sent just now.');
272
+ this.draft = '';
273
+ }
274
+ }
275
+ ```
276
+
277
+ ### 6. Reactive form + validation (forceInvalid + error text)
278
+
279
+ ```ts
280
+ import { Component } from '@angular/core';
281
+ import { FormControl, FormGroup, ReactiveFormsModule, Validators } from '@angular/forms';
282
+ import { HlmInputGroupImports } from '@egose/shadcn-theme-ng/input-group';
283
+ import { HlmError } from '@egose/shadcn-theme-ng/form-field';
284
+
285
+ @Component({
286
+ standalone: true,
287
+ imports: [ReactiveFormsModule, HlmInputGroupImports, HlmError],
288
+ template: `
289
+ <form [formGroup]="form" (ngSubmit)="submit()">
290
+ <div hlmInputGroup>
291
+ <span hlmInputGroupText>€</span>
292
+ <input
293
+ hlmInputGroupInput
294
+ type="number"
295
+ formControlName="price"
296
+ placeholder="0.00"
297
+ aria-label="Price in euros"
298
+ aria-describedby="price-error"
299
+ [forceInvalid]="showError()"
300
+ />
301
+ </div>
302
+ @if (showError()) {
303
+ <hlm-error id="price-error">Enter a price greater than 0.</hlm-error>
304
+ }
305
+ <button type="submit">Save</button>
306
+ </form>
307
+ `,
308
+ })
309
+ export class ValidationExample {
310
+ readonly form = new FormGroup({
311
+ price: new FormControl<number | null>(null, { validators: [Validators.required, Validators.min(0.01)] }),
312
+ });
313
+
314
+ showError(): boolean {
315
+ const c = this.form.controls.price;
316
+ return c.invalid && (c.dirty || c.touched);
317
+ }
318
+
319
+ submit() {
320
+ if (this.form.invalid) this.form.markAllAsTouched();
321
+ }
322
+ }
323
+ ```
324
+
325
+ ## Accessibility notes
326
+
327
+ - The container has `role="group"` — give the inner control an `aria-label` (or visible `<label>`) since add-on text is not automatically associated.
328
+ - Add-on text (`$`, `https://…`) is visual context; repeat the essential unit in the input's accessible name (`aria-label="Monthly budget in dollars"`), not just the placeholder.
329
+ - Icon-only `hlmInputGroupButton`s need an `aria-label` (`Copy token`, `Send`).
330
+ - Validation messages live outside the group — link them with `aria-describedby` + `forceInvalid` as in example 6 so the error ring and announcement stay in sync.
331
+
332
+ ## Theming / CSS variables
333
+
334
+ No component-specific CSS variables; borders, rings, and muted text come from the shared tokens (`--input`, `--ring`, `--muted-foreground`, `--destructive`, `--radius`). Width/height adapt to content — constrain with `tw:max-w-*` on the group.
335
+
336
+ ## Related subpaths
337
+
338
+ - `@egose/shadcn-theme-ng/input` — standalone `HlmInput` (what the group input extends).
339
+ - `@egose/shadcn-theme-ng/textarea` — `HlmTextarea` (what the group textarea extends).
340
+ - `@egose/shadcn-theme-ng/button` — `HlmBtn` variants behind the group button.
341
+ - `@egose/shadcn-theme-ng/kbd` — shortcut hints inside addons.
@@ -1,9 +1,9 @@
1
1
  import * as i0 from '@angular/core';
2
- import { Directive, input, NgModule } from '@angular/core';
3
- import { classes } from '@egose/shadcn-theme-ng/utils';
2
+ import { Directive, input, inject, effect, NgModule } from '@angular/core';
3
+ import { classes, hlm } from '@egose/shadcn-theme-ng/utils';
4
4
  import { cva } from 'class-variance-authority';
5
5
  import * as i1 from '@egose/shadcn-theme-ng/button';
6
- import { provideBrnButtonConfig, HlmBtn } from '@egose/shadcn-theme-ng/button';
6
+ import { HlmBtn, provideBrnButtonConfig } from '@egose/shadcn-theme-ng/button';
7
7
  import * as i1$1 from '@egose/shadcn-theme-ng/input';
8
8
  import { HlmInput } from '@egose/shadcn-theme-ng/input';
9
9
  import * as i1$2 from '@egose/shadcn-theme-ng/textarea';
@@ -11,7 +11,7 @@ import { HlmTextarea } from '@egose/shadcn-theme-ng/textarea';
11
11
 
12
12
  class HlmInputGroup {
13
13
  constructor() {
14
- classes(() => "border-input dark:bg-input/30 has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot][data-matches-spartan-invalid=true]]:ring-destructive/20 has-[[data-slot][data-matches-spartan-invalid=true]]:border-destructive dark:has-[[data-slot][data-matches-spartan-invalid=true]]:ring-destructive/40 h-9 rounded-md border shadow-xs transition-[color,box-shadow] in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot][data-matches-spartan-invalid=true]]:ring-3 has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pe-1.5 has-[>[data-align=inline-start]]:[&>input]:ps-1.5 group/input-group relative flex w-full min-w-0 items-center outline-none has-[>textarea]:h-auto");
14
+ classes(() => "border-input dark:bg-input/30 has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot][data-matches-spartan-invalid=true]]:ring-destructive/20 has-[[data-slot][data-matches-spartan-invalid=true]]:border-destructive dark:has-[[data-slot][data-matches-spartan-invalid=true]]:ring-destructive/40 h-9 rounded-md border shadow-xs transition-[color,box-shadow] in-data-[slot=combobox-content]:focus-within:border-inherit in-data-[slot=combobox-content]:focus-within:ring-0 has-[[data-slot=input-group-control]:focus-visible]:ring-3 has-[[data-slot][data-matches-spartan-invalid=true]]:ring-3 has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>[data-align=block-end]]:[&>input]:pt-3 has-[>[data-align=block-start]]:[&>input]:pb-3 has-[>[data-align=inline-end]]:[&>input]:pe-1.5 has-[>[data-align=inline-start]]:[&>input]:ps-1.5 group/input-group relative flex w-full min-w-0 max-w-full items-center outline-none has-[>textarea]:h-auto");
15
15
  }
16
16
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: HlmInputGroup, deps: [], target: i0.ɵɵFactoryTarget.Directive });
17
17
  static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.1.3", type: HlmInputGroup, isStandalone: true, selector: "[hlmInputGroup],hlm-input-group", host: { attributes: { "data-slot": "input-group", "role": "group" } }, ngImport: i0 });
@@ -27,11 +27,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
27
27
  }]
28
28
  }], ctorParameters: () => [] });
29
29
 
30
- const inputGroupAddonVariants$1 = cva("text-muted-foreground h-auto gap-2 py-1.5 text-sm font-medium group-data-[disabled=true]/input-group:opacity-50 [&>kbd]:rounded-[calc(var(--radius)-5px)] [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] flex cursor-text items-center justify-center select-none", {
30
+ const inputGroupAddonVariants$1 = cva("text-muted-foreground h-auto gap-2 py-1.5 text-sm font-medium group-data-[disabled=true]/input-group:opacity-50 [&>kbd]:rounded-[calc(var(--radius)-5px)] [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] flex shrink-0 cursor-text items-center justify-center select-none", {
31
31
  variants: {
32
32
  align: {
33
33
  'inline-start': "ps-2 has-[>button]:-ms-1 has-[>kbd]:ms-[-0.15rem] order-first",
34
- 'inline-end': "pe-2 has-[>button]:-me-1 has-[>kbd]:me-[-0.15rem] order-last",
34
+ 'inline-end': "pe-2 has-[>button]:pe-1 has-[>kbd]:me-[-0.15rem] order-last",
35
35
  'block-start': "px-2.5 pt-2 group-has-[>input]/input-group:pt-2 [.border-b]:pb-2 order-first w-full justify-start",
36
36
  'block-end': "px-2.5 pb-2 group-has-[>input]/input-group:pb-2 [.border-t]:pt-2 order-last w-full justify-start",
37
37
  },
@@ -64,10 +64,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
64
64
  const inputGroupAddonVariants = cva("gap-2 text-sm flex items-center shadow-none", {
65
65
  variants: {
66
66
  size: {
67
- xs: "h-6 gap-1 rounded-[calc(var(--radius)-5px)] px-1.5 [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(3.5)]",
67
+ xs: "h-6 gap-1 rounded-[calc(var(--radius)-5px)] px-1.5 [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(3.5)] [&_svg:not([class*='size-'])]:size-3.5",
68
68
  sm: '',
69
- 'icon-xs': "size-6 rounded-[calc(var(--radius)-5px)] p-0 has-[>ng-icon]:p-0",
70
- 'icon-sm': "size-8 p-0 has-[>ng-icon]:p-0",
69
+ 'icon-xs': "size-6 rounded-[calc(var(--radius)-5px)] p-0 has-[>ng-icon]:p-0 [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(3)] [&_svg:not([class*='size-'])]:size-3",
70
+ 'icon-sm': "size-8 p-0 has-[>ng-icon]:p-0 [&>ng-icon:not([class*='text-'])]:text-[length:--spacing(4)] [&_svg:not([class*='size-'])]:size-4",
71
71
  },
72
72
  },
73
73
  defaultVariants: {
@@ -75,15 +75,25 @@ const inputGroupAddonVariants = cva("gap-2 text-sm flex items-center shadow-none
75
75
  },
76
76
  });
77
77
  class HlmInputGroupButton {
78
+ _btn = inject(HlmBtn);
78
79
  size = input('xs', /* @ts-ignore */
79
80
  ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
80
81
  type = input('button', /* @ts-ignore */
81
82
  ...(ngDevMode ? [{ debugName: "type" }] : /* istanbul ignore next */ []));
83
+ userClass = input('', { ...(ngDevMode ? { debugName: "userClass" } : /* istanbul ignore next */ {}), alias: 'class' });
82
84
  constructor() {
83
- classes(() => inputGroupAddonVariants({ size: this.size() }));
85
+ // HlmBtn renders its classes through a `[class]` host binding, so layering
86
+ // another `classes()` call here would lose: the binding output is treated
87
+ // as base classes and merged last, letting HlmBtn's default `h-9 px-4 py-2`
88
+ // beat the input-group sizing and push the button onto the outer
89
+ // container's borders. Route the variant through `setClass()` instead so it
90
+ // wins over the button defaults while explicit `class` values still win.
91
+ effect(() => {
92
+ this._btn.setClass(hlm(inputGroupAddonVariants({ size: this.size() }), this.userClass()));
93
+ });
84
94
  }
85
95
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: HlmInputGroupButton, deps: [], target: i0.ɵɵFactoryTarget.Directive });
86
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.3", type: HlmInputGroupButton, isStandalone: true, selector: "button[hlmInputGroupButton]", inputs: { size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, type: { classPropertyName: "type", publicName: "type", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.data-size": "size()", "type": "type()" } }, providers: [
96
+ static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.1.3", type: HlmInputGroupButton, isStandalone: true, selector: "button[hlmInputGroupButton]", inputs: { size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, type: { classPropertyName: "type", publicName: "type", isSignal: true, isRequired: false, transformFunction: null }, userClass: { classPropertyName: "userClass", publicName: "class", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.data-size": "size()", "type": "type()" } }, providers: [
87
97
  provideBrnButtonConfig({
88
98
  variant: 'ghost',
89
99
  }),
@@ -109,7 +119,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
109
119
  '[type]': 'type()',
110
120
  },
111
121
  }]
112
- }], ctorParameters: () => [], propDecorators: { size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], type: [{ type: i0.Input, args: [{ isSignal: true, alias: "type", required: false }] }] } });
122
+ }], ctorParameters: () => [], propDecorators: { size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], type: [{ type: i0.Input, args: [{ isSignal: true, alias: "type", required: false }] }], userClass: [{ type: i0.Input, args: [{ isSignal: true, alias: "class", required: false }] }] } });
113
123
 
114
124
  class HlmInputGroupInput {
115
125
  constructor() {
@@ -1,4 +1,5 @@
1
1
  import * as i0 from '@angular/core';
2
+ import { ClassValue } from 'clsx';
2
3
  import * as i1 from '@egose/shadcn-theme-ng/button';
3
4
  import * as i1$1 from '@egose/shadcn-theme-ng/input';
4
5
  import * as i1$2 from '@egose/shadcn-theme-ng/textarea';
@@ -17,11 +18,13 @@ declare class HlmInputGroupAddon {
17
18
  }
18
19
 
19
20
  declare class HlmInputGroupButton {
21
+ private readonly _btn;
20
22
  readonly size: i0.InputSignal<"xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined>;
21
23
  readonly type: i0.InputSignal<"button" | "submit" | "reset">;
24
+ readonly userClass: i0.InputSignal<ClassValue>;
22
25
  constructor();
23
26
  static ɵfac: i0.ɵɵFactoryDeclaration<HlmInputGroupButton, never>;
24
- static ɵdir: i0.ɵɵDirectiveDeclaration<HlmInputGroupButton, "button[hlmInputGroupButton]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.HlmBtn; inputs: { "variant": "variant"; }; outputs: {}; }]>;
27
+ static ɵdir: i0.ɵɵDirectiveDeclaration<HlmInputGroupButton, "button[hlmInputGroupButton]", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.HlmBtn; inputs: { "variant": "variant"; }; outputs: {}; }]>;
25
28
  }
26
29
 
27
30
  declare class HlmInputGroupInput {