yukit-web 0.2.7 → 0.2.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yukit-web",
   "description": "Angular UI component library for Yurest web applications.",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "author": {
     "name": "Yurest Solutions",
     "email": "develop@yurest.com"

package/src/lib/theme/theme.css

@@ -31,13 +31,47 @@
     font-family: var(--font-sans);
   }
 
-  button:not(:disabled),
-  [role='button']:not(:disabled) {
+  :is(
+    button,
+    summary,
+    select,
+    input:is([type='checkbox'], [type='radio'], [type='range'], [type='file'], [type='button'], [type='submit']),
+    [role='button'],
+    [role='checkbox'],
+    [role='switch'],
+    [role='radio'],
+    [role='tab'],
+    [role='menuitem'],
+    [role='menuitemcheckbox'],
+    [role='menuitemradio'],
+    [role='option'],
+    [role='combobox']
+  ):not(:disabled, [aria-disabled='true'], [data-disabled]:not([data-disabled='false'])),
+  label:has(:is(input:is([type='checkbox'], [type='radio']), [role='checkbox'], [role='switch'], [role='radio'])):not(
+      :has(:is(:disabled, [aria-disabled='true'], [data-disabled]:not([data-disabled='false'])))
+    ) {
     cursor: pointer;
   }
 
-  button:disabled,
-  [role='button']:disabled {
+  :is(
+    button,
+    summary,
+    select,
+    input:is([type='checkbox'], [type='radio'], [type='range'], [type='file'], [type='button'], [type='submit']),
+    [role='button'],
+    [role='checkbox'],
+    [role='switch'],
+    [role='radio'],
+    [role='tab'],
+    [role='menuitem'],
+    [role='menuitemcheckbox'],
+    [role='menuitemradio'],
+    [role='option'],
+    [role='combobox']
+  ):is(:disabled, [aria-disabled='true'], [data-disabled]:not([data-disabled='false'])),
+  label:has(:is(input:is([type='checkbox'], [type='radio']), [role='checkbox'], [role='switch'], [role='radio'])):has(
+      :is(:disabled, [aria-disabled='true'], [data-disabled]:not([data-disabled='false']))
+    ) {
     cursor: not-allowed;
   }
 

package/types/yukit-web.d.ts

@@ -66,6 +66,9 @@ declare function cn(...inputs: ClassValue[]): string;
  * ```html
  * <button hlmBtn [size]="size()" [yuwClass]="_btnClass()">Save</button>
  * ```
+ *
+ * Inputs:
+ * - `yuwClass`: String of CSS classes registered as a replaceable `classes()` source on the host. Default is `''`.
  */
 declare class YuwClassDirective {
     readonly yuwClass: _angular_core.InputSignal<string>;
@@ -103,6 +106,10 @@ declare function provideValueAccessor(component: Type<unknown>): Provider;
  *
  * They're kept as two separate signals and OR'd together in `_disabled`: disabled by *either*
  * source means disabled. That's the only combination that never drops a caller's intent.
+ *
+ * Inputs:
+ * - `disabled`: Disables the form control and blocks user interaction. Combined with the disabled
+ *   state coming from the forms API, so either one disables it. Default is `false`.
  */
 declare abstract class YuwValueAccessorBase<T> implements ControlValueAccessor {
     private readonly _host;
@@ -137,6 +144,19 @@ declare abstract class YuwValueAccessorBase<T> implements ControlValueAccessor {
  * forward to its native input — lives one level down, per the Liskov rule in `AGENTS.md`.
  *
  * Subclasses provide `_autoId`, the fallback `id` used when the consumer sets no `inputId`.
+ *
+ * Inputs:
+ * - `class`: Extra CSS classes merged last onto the field's visual element, so they win over the
+ *   defaults. Bound through the `class` alias of an internal input. Default is `''`.
+ * - `errorText`: Error message shown under the field. Default is `undefined`.
+ * - `helperText`: Helper message shown under the field. Default is `undefined`.
+ * - `inputId`: ID set on the native input element, for `<label [for]>` matching. Falls back to a
+ *   generated ID when unset. Default is `undefined`.
+ * - `invalid`: Marks the field as invalid. Default is `false`.
+ * - `value`: Two-way bound (`[(value)]`) string value of the field. Default is `''`.
+ *
+ * Outputs:
+ * - `valueChange`: Emits the new string whenever `value` changes, enabling two-way binding.
  */
 declare abstract class YuwFieldBase extends YuwValueAccessorBase<string> {
     readonly errorText: _angular_core.InputSignal<string | undefined>;
@@ -177,6 +197,13 @@ interface YuwTextFieldContract {
  * the controls can't drift apart — the Liskov rule in `AGENTS.md`: same-role components share one
  * input contract. Anything only some of them honor (`maxlength`, `size`, `enterPressed`, …) stays
  * on the component, never here.
+ *
+ * Inputs:
+ * - `autocomplete`: Native `autocomplete` attribute forwarded to the control. Default is `undefined`.
+ * - `name`: Native `name` attribute forwarded to the control. Default is `undefined`.
+ * - `placeholder`: Native placeholder text. Default is `undefined`.
+ * - `readonly`: Makes the control read-only. Default is `false`.
+ * - `required`: Marks the control as required. Default is `false`.
  */
 declare abstract class YuwTextFieldBase extends YuwFieldBase implements YuwTextFieldContract {
     readonly autocomplete: _angular_core.InputSignal<string | undefined>;
@@ -229,6 +256,9 @@ interface YuwComboboxItemContext<TData = unknown> {
  *   </ng-template>
  * </yuw-combobox>
  * ```
+ *
+ * Inputs:
+ * - `yuwComboboxItemTypeOf`: Optional array of `YuwComboboxOptionDto`; only used to infer the generic data type of the template context for type checking. Default is `undefined`.
  */
 declare class YuwComboboxItemDirective<TData = unknown> {
     readonly templateRef: TemplateRef<YuwComboboxItemContext<TData>>;
@@ -402,6 +432,8 @@ type YuwColorDto = 'primary' | 'secondary' | 'neutral' | 'destructive' | 'succes
  * - `class`: Extra CSS classes merged onto the inner button/anchor; merged last, so they win over the component's own classes.
  * - `yuwDropdownMenuTrigger`: Optional dropdown menu template reference to trigger.
  * - `ariaLabel`: Accessible label for screen readers.
+ * - `animationDisabled`: Removes the pressed-state translate animation. Default is `false`. It is also
+ *   forced on when the host carries `aria-haspopup` (e.g. when used as an overlay trigger).
  *
  * Outputs:
  * - `clicked`: Emits MouseEvent on click.
@@ -604,6 +636,9 @@ declare class YuwButtonGroupComponent {
  *   </ng-template>
  * </yuw-button-group>
  * ```
+ *
+ * Inputs:
+ * - `yuwButtonGroupContent`: Required string; id of the button group entry this template renders the content of.
  */
 declare class YuwButtonGroupContentDirective {
     readonly templateRef: TemplateRef<unknown>;
@@ -619,6 +654,16 @@ declare class YuwButtonGroupContentDirective {
  * (`variant`), dismissible action (`removeLabel` / `removed`), and a compact dot mode (`dot`)
  * that renders no content at all.
  *
+ * Inputs:
+ * - `color`: Brand color theme (any `YuwColorDto` value). Default is `'primary'`.
+ * - `dot`: Renders a compact dot with no content, icon or remove button. Default is `false`.
+ * - `removeLabel`: Accessible label for the remove button; the button only renders when this is set. The app supplies
+ *   and translates it. Default is `undefined`.
+ * - `variant`: Helm badge style (`'default'`, `'secondary'`, `'destructive'`, `'outline'`, `'ghost'`, `'link'`). Default is `'default'`.
+ *
+ * Outputs:
+ * - `removed`: Emits when the remove button is clicked.
+ *
  * Usage:
  * ```html
  * <yuw-badge color="primary">New</yuw-badge>
@@ -653,6 +698,11 @@ interface YuwBreadcrumbItemDto {
  * (`aria-current="page"`); intermediate items render as links when they have an `href` and as
  * plain text otherwise.
  *
+ * Inputs:
+ * - `ariaLabel`: Required accessible label for the navigation landmark. The app supplies and translates it.
+ * - `items`: Required array of `YuwBreadcrumbItemDto` (`label`, optional `href`) in hierarchy order.
+ * - `separator`: Text rendered between items. Default is `'/'`.
+ *
  * Usage:
  * ```html
  * <yuw-breadcrumb
@@ -707,6 +757,19 @@ type YuwPaginationSizeDto = 'default' | 'xs' | 'sm' | 'lg' | 'icon' | 'icon-xs'
  * Controls two-way active page state `[(page)]`, accepts total pages (`totalPages`), accessible
  * previous/next/ellipsis labels, size and color theme.
  *
+ * Inputs:
+ * - `ariaLabel`: Required accessible label of the navigation landmark.
+ * - `color`: Brand color theme (any `YuwColorDto` value). Default is `'primary'`.
+ * - `ellipsisSrText`: Required screen reader text of the ellipsis between page ranges.
+ * - `nextLabel`: Required accessible label of the next page button.
+ * - `page`: Required two-way (`[(page)]`) active page, 1-based.
+ * - `previousLabel`: Required accessible label of the previous page button.
+ * - `size`: Button size (`YuwPaginationSizeDto`). Default is `'icon'`.
+ * - `totalPages`: Required total number of pages.
+ *
+ * Outputs:
+ * - `page`: Emits the new active page when the user picks one (the output half of `[(page)]`).
+ *
  * Usage:
  * ```html
  * <yuw-pagination
@@ -758,7 +821,14 @@ interface YuwListPaginationLabels {
     readonly ellipsis: string;
 }
 
-/** Page size selector and range message of a `YuwPagedList`; in a datatable it takes the pagination slot. */
+/**
+ * Page size selector and range message of a `YuwPagedList`; in a datatable it takes the pagination slot.
+ *
+ * Inputs:
+ * - `disabled`: Disables the page size selector. Default is `false`.
+ * - `labels`: Required `YuwPageSizeLabels` with the selector label, the text for an empty list and the function that builds the range message.
+ * - `list`: Required `YuwPagedList` whose page size is chosen and whose range is shown in the message.
+ */
 declare class YuwPageSizeComponent {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly labels: _angular_core.InputSignal<YuwPageSizeLabels>;
@@ -768,7 +838,15 @@ declare class YuwPageSizeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwPageSizeComponent, "yuw-page-size", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": true; "isSignal": true; }; "list": { "alias": "list"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Pagination footer for lists without a datatable. A disabled `fieldset` blocks its buttons. */
+/**
+ * Pagination footer for lists without a datatable: the page size selector with its range message
+ * and the page navigation, both driven by one `YuwPagedList`. A disabled `fieldset` blocks its buttons.
+ *
+ * Inputs:
+ * - `disabled`: Disables the page size selector and the page buttons. Default is `false`.
+ * - `labels`: Required `YuwListPaginationLabels` with the consumer's text for the page size selector, the navigation aria label and the previous, next and ellipsis texts.
+ * - `list`: Required `YuwPagedList` holding the current page, page size, total pages and range; changes made in the footer are written back to it.
+ */
 declare class YuwListPaginationComponent {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly labels: _angular_core.InputSignal<YuwListPaginationLabels>;
@@ -781,13 +859,31 @@ declare class YuwListPaginationComponent {
  * Page title, optional description and up to two actions, each rendered when its label is set.
  * On mobile the primary action shows only its icon, or `primaryMobileLabel`. Icons are `@ng-icons`
  * names; the consumer registers any beyond `lucidePlus` with `provideIcons`.
+ *
+ * Inputs:
+ * - `backLabel`: Text of the back button, which renders only when set; on small screens only its arrow shows.
+ * - `description`: Optional subtitle under the title.
+ * - `primaryDisabled`: Disables the primary action, which stays visible but ignores clicks, e.g. while the list it creates items for is loading.
+ * - `primaryIcon`: Icon name shown in the primary action.
+ * - `primaryLabel`: Text of the primary action, which renders only when set.
+ * - `primaryMobileLabel`: Text the primary action shows on small screens instead of its label.
+ * - `secondaryIcon`: Icon name shown in the secondary action.
+ * - `secondaryLabel`: Text of the secondary action, which renders only when set; hidden on small screens, leaving its icon.
+ * - `title`: Required page title.
+ *
+ * Outputs:
+ * - `backClicked`: Emits the `MouseEvent` of the back button.
+ * - `primaryClicked`: Emits the `MouseEvent` of the primary action.
+ * - `secondaryClicked`: Emits the `MouseEvent` of the secondary action.
  */
 declare class YuwPageHeaderComponent {
     readonly backLabel: _angular_core.InputSignal<string | undefined>;
     readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly primaryDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly primaryIcon: _angular_core.InputSignal<string | undefined>;
     readonly primaryLabel: _angular_core.InputSignal<string | undefined>;
     readonly primaryMobileLabel: _angular_core.InputSignal<string | undefined>;
+    readonly secondaryDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly secondaryIcon: _angular_core.InputSignal<string | undefined>;
     readonly secondaryLabel: _angular_core.InputSignal<string | undefined>;
     readonly title: _angular_core.InputSignal<string>;
@@ -796,7 +892,7 @@ declare class YuwPageHeaderComponent {
     readonly secondaryClicked: _angular_core.OutputEmitterRef<MouseEvent>;
     protected readonly isMobile: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwPageHeaderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwPageHeaderComponent, "yuw-page-header", never, { "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "primaryIcon": { "alias": "primaryIcon"; "required": false; "isSignal": true; }; "primaryLabel": { "alias": "primaryLabel"; "required": false; "isSignal": true; }; "primaryMobileLabel": { "alias": "primaryMobileLabel"; "required": false; "isSignal": true; }; "secondaryIcon": { "alias": "secondaryIcon"; "required": false; "isSignal": true; }; "secondaryLabel": { "alias": "secondaryLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "backClicked": "backClicked"; "primaryClicked": "primaryClicked"; "secondaryClicked": "secondaryClicked"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwPageHeaderComponent, "yuw-page-header", never, { "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "primaryDisabled": { "alias": "primaryDisabled"; "required": false; "isSignal": true; }; "primaryIcon": { "alias": "primaryIcon"; "required": false; "isSignal": true; }; "primaryLabel": { "alias": "primaryLabel"; "required": false; "isSignal": true; }; "primaryMobileLabel": { "alias": "primaryMobileLabel"; "required": false; "isSignal": true; }; "secondaryDisabled": { "alias": "secondaryDisabled"; "required": false; "isSignal": true; }; "secondaryIcon": { "alias": "secondaryIcon"; "required": false; "isSignal": true; }; "secondaryLabel": { "alias": "secondaryLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "backClicked": "backClicked"; "primaryClicked": "primaryClicked"; "secondaryClicked": "secondaryClicked"; }, never, never, true, never>;
 }
 
 /**
@@ -897,6 +993,7 @@ declare const YuwAccordionImports: readonly [typeof YuwAccordion, typeof YuwAcco
  *
  * Outputs:
  * - `committed`: Emits the current value on the native `change` event (blur/enter).
+ * - `enterPressed`: Emits (`void`) when the Enter key is pressed while the field is focused.
  *
  * Usage:
  * ```html
@@ -1134,6 +1231,7 @@ declare class YuwSearchInputComponent extends YuwTextFieldBase {
  *
  * Outputs:
  * - `committed`: Emits the current value on the native `change` event (blur/enter).
+ * - `enterPressed`: Emits (`void`) when the Enter key is pressed while the field is focused.
  *
  * Usage:
  * ```html
@@ -1200,6 +1298,7 @@ type YuwInputOtpModeDto = 'numeric' | 'text';
  *
  * Outputs:
  * - `completed`: Emits the full code string once the final slot is filled (by typing or paste).
+ * - `enterPressed`: Emits (`void`) when the Enter key is pressed while the field is focused.
  *
  * Usage:
  * ```html
@@ -1286,7 +1385,7 @@ declare class YuwLabel extends HlmLabel {
  * projected content, pair it with an external `<label [for]>` via `inputId` or set `ariaLabel`.
  *
  * Inputs / Models:
- * - `value` / `checked`: Two-way boolean state of the checkbox. Default is `false`.
+ * - `checked`: Two-way (`[(checked)]`) boolean checked state, alias of the internal `value` model. Default is `false`.
  * - `indeterminate`: Two-way boolean state for mixed/indeterminate checkbox appearance. Default is `false`.
  * - `disabled`: Disables checkbox interaction.
  * - `required`: Marks checkbox as required.
@@ -1341,6 +1440,8 @@ type YuwSwitchSizeDto = 'default' | 'xs' | 'sm' | 'lg';
  * - `disabled`: Disables switch interaction.
  * - `inputId`: HTML `id` for the underlying control, enabling external `<label for="...">` association.
  * - `ariaLabel`: Accessible name for switches with no visible adjacent label.
+ * - `ariaLabelledby`: Id of the element that labels the switch, set as `aria-labelledby` on the control.
+ * - `ariaDescribedby`: Id of the element that describes the switch, set as `aria-describedby` on the control.
  *
  * Usage:
  * ```html
@@ -1444,6 +1545,14 @@ declare class YuwSkeletonDirective {
  * `skeletonCount` placeholders shaped by `skeletonClass`; `empty` shows `emptyText`; `columnsClass`
  * holds the Tailwind column utilities.
  *
+ * Inputs:
+ * - `columnsClass`: Tailwind grid column utilities applied to the grid and its skeleton. Default is `'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4'`.
+ * - `empty`: Shows `emptyText` instead of the projected cards. Default is `false`.
+ * - `emptyText`: Required message shown when `empty` is set. The app supplies and translates it.
+ * - `loading`: Shows `skeletonCount` placeholders instead of the content; takes precedence over `empty`. Default is `false`.
+ * - `skeletonClass`: Extra classes sizing each placeholder, e.g. its height. Default is `'h-16'`.
+ * - `skeletonCount`: Number of placeholders shown while loading. Default is `12`.
+ *
  * `YuwCardGridComponent.COLUMNS` holds the column classes admin lists share per view mode — `list`
  * is one column, `block` grows from one to five, and `tags` packs small tag cards up to six — so every listing lays out its cards the same
  * way: `[columnsClass]="YuwCardGridComponent.COLUMNS[mode]"`.
@@ -1465,7 +1574,12 @@ declare class YuwCardGridComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwCardGridComponent, "yuw-card-grid", never, { "columnsClass": { "alias": "columnsClass"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": true; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "skeletonClass": { "alias": "skeletonClass"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
-/** While `pending` the card stays hidden in place under a skeleton, so the grid does not jump. */
+/**
+ * While `pending` the card stays hidden in place under a skeleton, so the grid does not jump.
+ *
+ * Inputs:
+ * - `pending`: Hides the projected card and overlays a skeleton while it is loading. Default is `false`.
+ */
 declare class YuwCardGridItemComponent {
     readonly pending: _angular_core.InputSignalWithTransform<boolean, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwCardGridItemComponent, never>;
@@ -1660,6 +1774,10 @@ declare class YuwContextMenuSubIndicatorComponent {
  *   </div>
  * </ng-template>
  * ```
+ *
+ * Inputs:
+ * - `yuwContextMenuTrigger`: Required `TemplateRef` of the menu to open on right-click.
+ * - `yuwContextMenuTriggerData`: Optional data made available to the menu template as its context. Default is `undefined`.
  */
 declare class YuwContextMenuTriggerDirective {
     private readonly _trigger;
@@ -1697,6 +1815,10 @@ declare class YuwContextMenuItemDirective {
  *   <yuw-context-menu-checkbox-indicator />
  * </button>
  * ```
+ *
+ * Inputs:
+ * - `checked`: Whether the item is currently checked, which shows the projected indicator. Default is `false`.
+ * - `disabled`: Disables the item so it cannot be triggered. Default is `false`.
  */
 declare class YuwContextMenuCheckboxDirective {
     private readonly _item;
@@ -1724,6 +1846,10 @@ declare class YuwContextMenuCheckboxDirective {
  *   </button>
  * </div>
  * ```
+ *
+ * Inputs:
+ * - `checked`: Whether the item is the selected option, which shows the projected indicator. Default is `false`.
+ * - `disabled`: Disables the item so it cannot be selected. Default is `false`.
  */
 declare class YuwContextMenuRadioDirective {
     private readonly _item;
@@ -1769,6 +1895,9 @@ declare class YuwContextMenuSubDirective {
  *   <yuw-context-menu-sub-indicator />
  * </button>
  * ```
+ *
+ * Inputs:
+ * - `yuwContextMenuSubTrigger`: Required `TemplateRef` of the sub-menu this item expands.
  */
 declare class YuwContextMenuSubTriggerDirective {
     private readonly _trigger;
@@ -1798,6 +1927,7 @@ type YuwDatepickerModeDto = 'single' | 'range' | 'multiple' | 'monthYear';
  * - `align`: Popover alignment relative to trigger (`'start'`, `'center'`, `'end'`). Default is `'start'`.
  * - `buttonId`: HTML `id` for the trigger button, enabling external `<label for="...">`
  *   association. When omitted, a unique per-instance id is generated.
+ * - `size`: Trigger button height (`YuwFieldSizeDto`), matching the `<yuw-button>` size of the same name. Default is `'default'`.
  * - `class`: Extra classes merged onto the trigger button (e.g. a width), consumer classes win.
  * - `invalid`: Forces invalid styling.
  * - `formatDate`: Custom date formatter function `(date: Date) => string` for the trigger label.
@@ -2001,6 +2131,24 @@ interface YuwListToolbarLabels {
  * two-way to it (`viewModeChange` is the click listener); its names come from `labels.viewMode`. Saved filter sets need `filterSets` and `labels.filters.sets`;
  * the toolbar emits `setSaved`, `setRenamed` and `setDeleted` and the consumer persists them. `labels` holds every text and the consumer translates it;
  * `idleColor` is the filter trigger tone while nothing is applied.
+ *
+ * Inputs:
+ * - `filterGroups`: Filter groups the editor offers; the filter control renders only when set.
+ * - `filterSets`: Saved filter sets; together with `labels.filters.sets` it enables the sets star.
+ * - `filtersDisabled`: Disables the filter buttons. Default is `false`.
+ * - `hiddenColumns`: Two-way (`[(hiddenColumns)]`) ids of the columns currently hidden. Default is `[]`.
+ * - `hideableColumns`: Options of the columns the user may hide; the columns button renders only when set.
+ * - `idleColor`: `YuwColorDto` tone of the filter trigger while nothing is applied. Default is `'neutral'`.
+ * - `labels`: Required `YuwListToolbarLabels` with the consumer's translated text for every control.
+ * - `search`: Two-way (`[(search)]`) text of the search field. Default is `''`.
+ * - `searchPlaceholder`: Placeholder of the search field; the search renders only when set.
+ * - `selection`: Two-way (`[(selection)]`) applied filter selection, values keyed by group id. Default is `{}`.
+ * - `showExport`: Renders the export button. Default is `false`.
+ * - `viewMode`: Two-way (`[(viewMode)]`) `YuwViewMode` (`'list'` or `'block'`); the list/block switch renders only when set.
+ *
+ * Outputs:
+ * - `exported`: Emits the `MouseEvent` of the export button click.
+ * - `searched`: Emits the current search text on every keystroke and when it is cleared.
  */
 declare class YuwListToolbarComponent {
     readonly filterGroups: _angular_core.InputSignal<readonly YuwFilterGroupDto[] | undefined>;
@@ -2179,7 +2327,7 @@ type YuwDatatableRowClass<TData extends RowData> = string | ((row: TData, index:
  *   `(row, index) => string | undefined` callback to vary them per row (`YuwDatatableRowClass`).
  * - `appearance`: Visual treatment (`YuwDatatableAppearanceDto`). Default is `'default'` —
  *   Spartan's plain table. `'card'` frames the table in its own rounded bordered surface with a
- *   tinted uppercase header strip and taller rows; the consumer needs no wrapper of its own.
+ *   tinted header strip and taller rows; the consumer needs no wrapper of its own.
  *
  * Per-column, through TanStack's `meta` (see `YuwDatatableColumnMeta`). Every class-valued entry
  * takes Tailwind classes, so a column can size itself per breakpoint (`'w-40 lg:w-64'`). They are
@@ -2260,7 +2408,6 @@ declare class YuwDatatableComponent<TData extends RowData> implements OnInit {
     readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly sortable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly sorting: _angular_core.ModelSignal<SortingState>;
-    readonly summary: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly tableClass: _angular_core.InputSignal<string | undefined>;
     readonly totalItems: _angular_core.InputSignal<number | undefined>;
     protected rowClicked: _angular_core.OutputEmitterRef<TData>;
@@ -2302,7 +2449,7 @@ declare class YuwDatatableComponent<TData extends RowData> implements OnInit {
     protected onRowClick(row: TData): void;
     protected onRowKeydown(event: KeyboardEvent, row: TData): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwDatatableComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwDatatableComponent<any>, "yuw-datatable", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "cellClass": { "alias": "cellClass"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "columnVisibility": { "alias": "columnVisibility"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingRows": { "alias": "loadingRows"; "required": false; "isSignal": true; }; "nextPageLabel": { "alias": "nextPageLabel"; "required": true; "isSignal": true; }; "paginated": { "alias": "paginated"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "paginationAriaLabel": { "alias": "paginationAriaLabel"; "required": true; "isSignal": true; }; "paginationEllipsisSrText": { "alias": "paginationEllipsisSrText"; "required": true; "isSignal": true; }; "previousPageLabel": { "alias": "previousPageLabel"; "required": true; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "rowSelection": { "alias": "rowSelection"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "sortable": { "alias": "sortable"; "required": false; "isSignal": true; }; "sorting": { "alias": "sorting"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "tableClass": { "alias": "tableClass"; "required": false; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; }, { "columnFilters": "columnFiltersChange"; "columnVisibility": "columnVisibilityChange"; "pagination": "paginationChange"; "rowSelection": "rowSelectionChange"; "sorting": "sortingChange"; "rowClicked": "rowClicked"; "selectedRowsChange": "selectedRowsChange"; }, ["customPagination"], ["[yuwDatatablePagination]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwDatatableComponent<any>, "yuw-datatable", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "cellClass": { "alias": "cellClass"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "columnVisibility": { "alias": "columnVisibility"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingRows": { "alias": "loadingRows"; "required": false; "isSignal": true; }; "nextPageLabel": { "alias": "nextPageLabel"; "required": true; "isSignal": true; }; "paginated": { "alias": "paginated"; "required": false; "isSignal": true; }; "pagination": { "alias": "pagination"; "required": false; "isSignal": true; }; "paginationAriaLabel": { "alias": "paginationAriaLabel"; "required": true; "isSignal": true; }; "paginationEllipsisSrText": { "alias": "paginationEllipsisSrText"; "required": true; "isSignal": true; }; "previousPageLabel": { "alias": "previousPageLabel"; "required": true; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "rowSelection": { "alias": "rowSelection"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "sortable": { "alias": "sortable"; "required": false; "isSignal": true; }; "sorting": { "alias": "sorting"; "required": false; "isSignal": true; }; "tableClass": { "alias": "tableClass"; "required": false; "isSignal": true; }; "totalItems": { "alias": "totalItems"; "required": false; "isSignal": true; }; }, { "columnFilters": "columnFiltersChange"; "columnVisibility": "columnVisibilityChange"; "pagination": "paginationChange"; "rowSelection": "rowSelectionChange"; "sorting": "sortingChange"; "rowClicked": "rowClicked"; "selectedRowsChange": "selectedRowsChange"; }, ["customPagination"], ["[yuwDatatablePagination]"], true, never>;
 }
 
 /**
@@ -2310,6 +2457,16 @@ declare class YuwDatatableComponent<TData extends RowData> implements OnInit {
  * checkbox nor the cell around it triggers the row's own action, since `yuw-datatable` emits
  * `rowClicked` from the `<tr>`. `onToggle` is an input because `flexRenderComponent` does not
  * subscribe outputs.
+ *
+ * Renders a single `yuw-checkbox` meant to be used as the `select` display column of `yuw-datatable`
+ * (header for select-all, cell for a single row), wired to TanStack's toggle handlers.
+ *
+ * Inputs:
+ * - `checked`: Whether the checkbox is checked. Default is `false`.
+ * - `indeterminate`: Shows the mixed state, e.g. for a header when only some rows are selected. Default is `false`.
+ * - `label`: Accessible name (`aria-label`) of the checkbox. Default is `'Select row'`; consuming apps should
+ *   override it with translated text.
+ * - `onToggle`: Callback run when the checkbox changes. Default is a no-op.
  */
 declare class YuwDatatableRowSelect {
     readonly checked: _angular_core.InputSignal<boolean>;
@@ -2326,6 +2483,11 @@ declare class YuwDatatableRowSelect {
  * Pencil button cell that runs `onEdit`, hidden until its row is hovered or keyboard-focused (`yuw-reveal`,
  * see `theme/components/reveal-on-hover.css`); touch devices keep it visible. An input because `flexRenderComponent` does not subscribe
  * outputs. The host stops the click so a clickable row does not fire twice.
+ *
+ * Inputs:
+ * - `label` (required): Accessible name (`aria-label`) of the pencil button. User-facing text the
+ *   consuming app is responsible for translating.
+ * - `onEdit`: Callback run when the button is clicked. Default is a no-op.
  */
 declare class YuwActionsCellComponent {
     readonly label: _angular_core.InputSignal<string>;
@@ -2575,7 +2737,7 @@ type YuwPopoverAlignDto = 'start' | 'center' | 'end';
  * - `showTrigger`: Whether to render the trigger button. Set `false` when opening only via `[(open)]`.
  * - `align`: Panel alignment relative to trigger (`'start'`, `'center'`, `'end'`). Default is `'center'`.
  * - `sideOffset`: Pixel offset between the trigger and the panel. Default is `4`.
- * - `sideOffset`: Pixel offset for X sides. Positive px for right, negative for left side.
+ * - `offsetX`: Pixel offset for X sides. Positive px for right, negative for left side.
  * - `title`: Optional header title text. User-facing text the consuming app is responsible for translating.
  * - `description`: Optional header description text. User-facing text the consuming app is responsible for translating.
  * - `panelClass`: Extra classes merged onto the popover panel (e.g. `w-80` to widen it). They win
@@ -2837,6 +2999,7 @@ declare class YuwDialogFooterDirective {
  *   text the consuming app is responsible for translating.
  * - `panelClass`: Extra classes merged onto the dialog panel (e.g. `sm:max-w-lg` to widen it).
  *   They win over the library defaults via `twMerge`.
+ * - `triggerColor`: Brand color theme for the trigger button (any `YuwColorDto` value). Default is `'neutral'`.
  * - `triggerVariant`: Button style variant for the trigger button. Default is `'outline'`.
  * - `triggerSize`: Button size for the trigger button.
  *
@@ -2992,6 +3155,9 @@ interface YuwTabItemDto {
  * ```html
  * <ng-template yuwTabPanel="billing">Contenido de facturación</ng-template>
  * ```
+ *
+ * Inputs:
+ * - `yuwTabPanel`: Required string; id of the tab, matching an entry in the `tabs` input, that this panel renders for.
  */
 declare class YuwTabPanelDirective {
     readonly templateRef: TemplateRef<unknown>;
@@ -3020,6 +3186,7 @@ type YuwTabsActivationModeDto = 'automatic' | 'manual';
  * - `orientation`: Layout direction (`'horizontal'`, `'vertical'`). Default is `'horizontal'`.
  * - `activationMode`: How keyboard focus activates tabs (`'automatic'` activates on focus,
  *   `'manual'` requires Enter/Space). Default is `'automatic'`.
+ * - `class`: Extra classes merged onto the tab list, last, so they win over the component's own classes.
  *
  * Usage:
  * ```html
@@ -3051,6 +3218,13 @@ declare class YuwTabsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwTabsComponent, "yuw-tabs", never, { "activationMode": { "alias": "activationMode"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": true; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tabs": { "alias": "tabs"; "required": true; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; }, ["_contents", "panels"], never, true, never>;
 }
 
+/**
+ * Declares the content of a single tab entry. Apply it to an `<ng-template>` and pass the id of the
+ * entry it belongs to; the template is exposed through `templateRef` for the host to render.
+ *
+ * Inputs:
+ * - `yuwTabContent`: Required string; id of the tab entry this template is the content of.
+ */
 declare class YuwTabContentDirective {
     readonly templateRef: TemplateRef<unknown>;
     readonly entryId: _angular_core.InputSignal<string>;
@@ -3701,6 +3875,9 @@ declare class YuwSidebarMenuButtonDirective {
  * branches and cannot attach a directive conditionally — an attribute selector matches on presence, so
  * the nav applies it to every entry and passes whether that entry actually has an avatar. Its default
  * is `true` so the bare, hand-written form needs no value.
+ *
+ * Inputs:
+ * - `yuwSidebarMenuAvatarButton`: Boolean; whether the avatar geometry class is applied. An empty attribute counts as `true`; `false` applies nothing. Default is `true`.
  */
 declare class YuwSidebarMenuAvatarButtonDirective {
     readonly enabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -3747,6 +3924,9 @@ declare class YuwSidebarSeparatorDirective {
  *
  * `label` is the accessible label of the rail button (it has no visible text). User-facing text —
  * the consuming app is responsible for providing it already translated.
+ *
+ * Inputs:
+ * - `label`: Required accessible label (`aria-label`) of the rail button.
  */
 declare class YuwSidebarRailDirective {
     readonly label: _angular_core.InputSignal<string>;