yukit-web 0.0.16 → 0.0.18

package/package.json

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

package/src/lib/theme/tokens/component-colors.css

@@ -106,6 +106,14 @@
   --input: var(--yuw-accent);
 }
 
+[data-yuw-color] button.bg-background:not(:disabled):hover {
+  --muted: color-mix(in oklab, var(--yuw-accent) 5%, transparent);
+}
+
+[data-yuw-color] button.hover\:text-foreground:not(:disabled):hover {
+  --muted: color-mix(in oklab, var(--yuw-accent) 5%, transparent);
+}
+
 [data-yuw-color='secondary'] {
   --border: var(--neutrals-outline-accent);
 }
@@ -156,6 +164,14 @@
   --secondary-foreground: var(--neutrals-white);
 }
 
+.dark [data-yuw-color] button.bg-background:not(:disabled):hover {
+  --muted: color-mix(in oklab, var(--yuw-accent) 50%, transparent) !important;
+}
+
+.dark [data-yuw-color] button.hover\:text-foreground:not(:disabled):hover {
+  --muted: color-mix(in oklab, var(--yuw-accent) 50%, transparent) !important;
+}
+
 html body yuw-button[data-yuw-color] button:disabled {
   --yuw-accent: var(--neutrals-element-disabled);
   --yuw-accent-foreground: var(--neutrals-white);

package/types/yukit-web.d.ts

@@ -24,12 +24,14 @@ import * as i1$9 from '@spartan-ng/brain/tooltip';
 import { ToastOptions } from '@spartan-ng/brain/sonner';
 export { toast as yuwToast } from '@spartan-ng/brain/sonner';
 import * as i1$a from '@spartan-ng/brain/dialog';
+import { BrnDialogState } from '@spartan-ng/brain/dialog';
 import * as i1$b from '@spartan-ng/brain/alert-dialog';
 import * as i1$c from 'yukit-web/helm/attachment';
 import { HlmAttachmentAction } from 'yukit-web/helm/attachment';
 import { RouterLink } from '@angular/router';
 import * as i1$d from 'yukit-web/helm/sidebar';
 export { HlmSidebarConfig as YuwSidebarConfigDto, HlmSidebarService as YuwSidebarService, SidebarVariant as YuwSidebarServiceVariantDto, provideHlmSidebarConfig as provideYuwSidebarConfig } from 'yukit-web/helm/sidebar';
+import { CommandFilter } from '@spartan-ng/brain/command';
 
 /**
  * Merges class lists the shadcn/Spartan way: `clsx` resolves conditionals/arrays, `twMerge`
@@ -41,6 +43,37 @@ export { HlmSidebarConfig as YuwSidebarConfigDto, HlmSidebarService as YuwSideba
  */
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * Applies dynamic classes to an element that is also styled by a helm directive.
+ *
+ * @remarks
+ * The helm layer owns the `class` attribute through its `classes()` utility, which keeps a
+ * registry of *sources* per element and rewrites the attribute whenever any of them changes. It
+ * also watches the attribute with a `MutationObserver` and treats every write it did not make
+ * itself as consumer-authored *base* classes, which it merges **last** so they win.
+ *
+ * An Angular `[class]` binding on the same element is exactly such a foreign write, so the first
+ * value it emits is captured as a base class and then beats every value the binding emits
+ * afterwards — the element is pinned to whatever it rendered with. Because `hlm()` merges through
+ * `twMerge`, only classes of the same Tailwind group are pinned, which is why a dynamic `size`
+ * (`h-10` vs `h-11`) freezes while an unrelated `class` input still appears to work.
+ *
+ * Binding `[yuwClass]` instead registers the value as a regular `classes()` source: it is
+ * replaceable on every change, and still merges after the helm directive's own variants, so it
+ * keeps the precedence a `[class]` binding had.
+ *
+ * @example
+ * ```html
+ * <button hlmBtn [size]="size()" [yuwClass]="_btnClass()">Save</button>
+ * ```
+ */
+declare class YuwClassDirective {
+    readonly yuwClass: _angular_core.InputSignal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwClassDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<YuwClassDirective, "[yuwClass]", never, { "yuwClass": { "alias": "yuwClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Registers a component as a form control, so `formControlName`/`formControl`/`ngModel` bind to it.
  *
@@ -127,7 +160,10 @@ type YuwColorDto = 'primary' | 'secondary' | 'destructive' | 'success' | 'warnin
  * Outputs:
  * - `clicked`: Emits MouseEvent on click.
  *
- * `_btnClass` merges our variant layer with the consumer's `class`, which goes last so it wins.
+ * `_btnClass` merges our variant layer with the consumer's `class`, which goes last so it wins. It
+ * reaches the inner element through `[yuwClass]` rather than `[class]`: the helm layer owns the
+ * `class` attribute and treats a foreign write as consumer-authored base classes that it merges
+ * last, which would pin the first rendered value and stop `size` from ever changing again.
  *
  * The host carries `inline-flex` so it is a real box rather than an inline one: an overlay trigger
  * directive composed onto `<yuw-button>` (see `YuwPopoverTriggerDirective`) anchors its panel to the
@@ -855,10 +891,10 @@ declare class YuwSearchInputComponent extends YuwValueAccessorBase<string> imple
     protected readonly _collapsible: _angular_core.Signal<boolean>;
     protected readonly _disabled: _angular_core.Signal<boolean>;
     protected readonly _expandButtonClasses: _angular_core.Signal<string>;
-    protected readonly _expanded: _angular_core.Signal<boolean>;
     protected readonly _fieldClasses: _angular_core.Signal<string>;
     protected readonly _iconClasses: _angular_core.Signal<string>;
     protected readonly _inputId: _angular_core.Signal<string>;
+    readonly expanded: _angular_core.Signal<boolean>;
     protected readonly _showClear: _angular_core.Signal<boolean>;
     protected readonly _showExpandButton: _angular_core.Signal<boolean>;
     protected readonly _wrapperClasses: _angular_core.Signal<string>;
@@ -2104,11 +2140,14 @@ 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.
  * - `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
  *   over the library defaults via `twMerge`.
  * - `triggerVariant`: Button style variant for the trigger button.
+ * - `triggerColor`: Brand color theme for the trigger button (any `YuwColorDto` value). Default is
+ *   `'secondary'`.
  * - `triggerSize`: Button size for the trigger button.
  * - `triggerTransparent`: Strips the trigger's background and border in every state (rest, hover,
  *   open), for triggers whose projected content is the whole control — an avatar, a name, a chevron.
@@ -2130,19 +2169,21 @@ type YuwPopoverAlignDto = 'start' | 'center' | 'end';
 declare class YuwPopoverComponent {
     readonly align: _angular_core.InputSignal<YuwPopoverAlignDto>;
     readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly offsetX: _angular_core.InputSignal<number>;
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly panelClass: _angular_core.InputSignal<string | undefined>;
     readonly showTrigger: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly sideOffset: _angular_core.InputSignal<number>;
     readonly title: _angular_core.InputSignal<string | undefined>;
     readonly triggerClass: _angular_core.InputSignal<string>;
+    readonly triggerColor: _angular_core.InputSignal<YuwColorDto>;
     readonly triggerSize: _angular_core.InputSignal<"default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined>;
     readonly triggerTransparent: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly triggerVariant: _angular_core.InputSignal<"default" | "secondary" | "destructive" | "outline" | "ghost" | "link" | null | undefined>;
     protected readonly _popoverState: _angular_core.Signal<"open" | "closed">;
     protected onOpenChange(state: 'open' | 'closed'): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwPopoverComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwPopoverComponent, "yuw-popover", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "showTrigger": { "alias": "showTrigger"; "required": false; "isSignal": true; }; "sideOffset": { "alias": "sideOffset"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "triggerClass": { "alias": "triggerClass"; "required": false; "isSignal": true; }; "triggerSize": { "alias": "triggerSize"; "required": false; "isSignal": true; }; "triggerTransparent": { "alias": "triggerTransparent"; "required": false; "isSignal": true; }; "triggerVariant": { "alias": "triggerVariant"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[yuwPopoverTrigger]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwPopoverComponent, "yuw-popover", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "offsetX": { "alias": "offsetX"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "showTrigger": { "alias": "showTrigger"; "required": false; "isSignal": true; }; "sideOffset": { "alias": "sideOffset"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "triggerClass": { "alias": "triggerClass"; "required": false; "isSignal": true; }; "triggerColor": { "alias": "triggerColor"; "required": false; "isSignal": true; }; "triggerSize": { "alias": "triggerSize"; "required": false; "isSignal": true; }; "triggerTransparent": { "alias": "triggerTransparent"; "required": false; "isSignal": true; }; "triggerVariant": { "alias": "triggerVariant"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[yuwPopoverTrigger]", "*"], true, never>;
 }
 
 /**
@@ -3261,5 +3302,198 @@ declare const YUW_SIDEBAR_RAIL_PADDING = "22px";
 declare const YUW_SIDEBAR_RAIL_ICON_SIZE = "20px";
 declare const YUW_SIDEBAR_RAIL_WIDTH = "78px";
 
-export { DATATABLE_ALIGN_CLASS, YUW_PASSWORD_REVEAL_STATES, YUW_SIDEBAR_RAIL_ICON_SIZE, YUW_SIDEBAR_RAIL_PADDING, YUW_SIDEBAR_RAIL_WIDTH, YuwAccordion, YuwAccordionContentComponent, YuwAccordionImports, YuwAccordionItem, YuwAccordionTriggerComponent, YuwAlertActionDirective, YuwAlertComponent, YuwAlertDescriptionDirective, YuwAlertDialogComponent, YuwAlertDialogMediaDirective, YuwAlertDialogTriggerDirective, YuwAlertImports, YuwAlertTitleDirective, YuwAttachmentActionDirective, YuwAttachmentActionsDirective, YuwAttachmentContentDirective, YuwAttachmentDescriptionDirective, YuwAttachmentDirective, YuwAttachmentGroupDirective, YuwAttachmentMediaDirective, YuwAttachmentTitleDirective, YuwAttachmentTriggerDirective, YuwAvatarComponent, YuwBadgeComponent, YuwBreadcrumbComponent, YuwButtonComponent, YuwButtonGroupComponent, YuwButtonGroupContentDirective, YuwCaptionDirective, YuwCardActionDirective, YuwCardContentDirective, YuwCardDescriptionDirective, YuwCardDirective, YuwCardFooterDirective, YuwCardHeaderDirective, YuwCardImports, YuwCardTitleDirective, YuwCheckboxComponent, YuwComboboxComponent, YuwComboboxItemDirective, YuwContextMenuCheckboxDirective, YuwContextMenuCheckboxIndicatorComponent, YuwContextMenuDirective, YuwContextMenuGroupDirective, YuwContextMenuImports, YuwContextMenuItemDirective, YuwContextMenuLabelDirective, YuwContextMenuRadioDirective, YuwContextMenuRadioIndicatorComponent, YuwContextMenuSeparatorDirective, YuwContextMenuShortcutDirective, YuwContextMenuSubDirective, YuwContextMenuSubIndicatorComponent, YuwContextMenuSubTriggerDirective, YuwContextMenuTriggerDirective, YuwDatatableComponent, YuwDatatablePaginationDirective, YuwDatatableRowSelect, YuwDatepickerComponent, YuwDialogCloseDirective, YuwDialogComponent, YuwDialogFooterDirective, YuwDialogImports, YuwDialogTriggerDirective, YuwEmptyContentDirective, YuwEmptyDescriptionDirective, YuwEmptyDirective, YuwEmptyHeaderDirective, YuwEmptyImports, YuwEmptyMediaDirective, YuwEmptyTitleDirective, YuwInputAddonImports, YuwInputComponent, YuwInputOtpComponent, YuwItemActionsDirective, YuwItemContentDirective, YuwItemDescriptionDirective, YuwItemDirective, YuwItemFooterDirective, YuwItemGroupDirective, YuwItemHeaderDirective, YuwItemImports, YuwItemMediaDirective, YuwItemSeparatorDirective, YuwItemTitleDirective, YuwLabel, YuwLeftAddonDirective, YuwPaginationComponent, YuwPasswordInputComponent, YuwPopoverComponent, YuwPopoverTriggerDirective, YuwRadioGroupComponent, YuwRightAddonDirective, YuwSearchInputComponent, YuwSheetCloseDirective, YuwSheetComponent, YuwSheetFooterDirective, YuwSheetImports, YuwSheetTriggerDirective, YuwSidebarComponent, YuwSidebarContentDirective, YuwSidebarContentExtraDirective, YuwSidebarFooterDirective, YuwSidebarFooterExtraDirective, YuwSidebarGroupContentDirective, YuwSidebarGroupDirective, YuwSidebarGroupLabelDirective, YuwSidebarHeaderDirective, YuwSidebarInsetDirective, YuwSidebarMenuAvatarButtonDirective, YuwSidebarMenuBadgeDirective, YuwSidebarMenuButtonDirective, YuwSidebarMenuDirective, YuwSidebarMenuItemDirective, YuwSidebarMenuSubButtonDirective, YuwSidebarMenuSubDirective, YuwSidebarMenuSubItemDirective, YuwSidebarRailDirective, YuwSidebarRailService, YuwSidebarSeparatorDirective, YuwSidebarSubmenuService, YuwSidebarTriggerComponent, YuwSidebarWrapperDirective, YuwSkeletonDirective, YuwSpinnerComponent, YuwSwitchComponent, YuwTBodyDirective, YuwTFootDirective, YuwTHeadDirective, YuwTabPanelDirective, YuwTableContainerDirective, YuwTableDirective, YuwTableImports, YuwTabsComponent, YuwTdDirective, YuwTextareaComponent, YuwThDirective, YuwToasterComponent, YuwTooltipDirective, YuwTrDirective, YuwValueAccessorBase, buildInputOtpGroups, cn, datatableCellVariants, datatableContainerVariants, datatableHeadVariants, datatableHeaderCellVariants, datatableRowVariants, getPaginationRange, provideValueAccessor, totalInputOtpLength };
-export type { YuwAlertDialogSizeDto, YuwAlertVariantDto, YuwAvatarGroupItemDto, YuwAvatarSizeDto, YuwBreadcrumbItemDto, YuwButtonGroupClickDto, YuwButtonGroupItemDto, YuwColorDto, YuwComboboxItemContext, YuwComboboxOptionDto, YuwComboboxValue, YuwDatatableAlign, YuwDatatableAppearanceDto, YuwDatatableColumnDef, YuwDatepickerModeDto, YuwDatepickerValue, YuwFieldSizeDto, YuwInputModeDto, YuwInputOtpGroupDto, YuwInputOtpModeDto, YuwInputTypeDto, YuwPaginationRangeItem, YuwPaginationSizeDto, YuwPasswordRevealStateDto, YuwPopoverAlignDto, YuwRadioOptionDto, YuwSearchInputCollapseFromDto, YuwSheetScrollStrategyDto, YuwSheetSideDto, YuwSidebarAvatarDto, YuwSidebarCollapsibleDto, YuwSidebarContentDto, YuwSidebarGroupDto, YuwSidebarItemClickDto, YuwSidebarItemDto, YuwSidebarSideDto, YuwSidebarSubItemDto, YuwSidebarVariantDto, YuwSwitchSizeDto, YuwTabItemDto, YuwTabsActivationModeDto, YuwTabsOrientationDto, YuwTabsVariantDto, YuwTextFieldContract, YuwToasterPositionDto, YuwToasterThemeDto, YuwTooltipPositionDto };
+/**
+ * A single runnable entry of `<yuw-command>`.
+ *
+ * - `id`: identity of the entry, echoed back by `commandSelected` and used as the `@for` track key.
+ * - `label`: text of the entry, supplied already translated — the component owns no user-facing copy.
+ * - `searchText`: text the filter matches on, when matching `label` alone is not enough (aliases,
+ *   a keyword list, an accented-stripped form). Absent, `label` is what gets searched.
+ * - `icon`: name of a registered `@ng-icons` icon. Because the *consumer* chooses this name, the
+ *   consuming app is responsible for `provideIcons()`-ing it; that is a component-level provider,
+ *   so a name registered on the component hosting the command resolves here through the injector
+ *   chain.
+ * - `shortcut`: trailing key hint, rendered verbatim. Presentational only — it displays the
+ *   accelerator, it does not bind one. Platform-correct text is the consumer's job, the same as
+ *   translation: pass `'⌘K'` on Apple platforms and `'Ctrl+K'` elsewhere, deciding with
+ *   `Platform` from `@angular/cdk/platform`. The component renders the string as given, so a
+ *   hardcoded `'⌘K'` will show the Command glyph to Windows and Linux users too.
+ * - `disabled`: blocks selection while keeping the entry visible and searchable.
+ * - `action`: what to run when the entry is chosen. Present for the ordinary case where an entry
+ *   *is* its callback; entries needing wider context leave it out and let the parent handle
+ *   `commandSelected`, which fires for every entry either way.
+ */
+interface YuwCommandItemDto {
+    id: string;
+    label: string;
+    searchText?: string;
+    icon?: string;
+    shortcut?: string;
+    disabled?: boolean;
+    action?: () => void;
+}
+/**
+ * A titled run of {@link YuwCommandItemDto}s.
+ *
+ * `label` is optional so an ungrouped palette is expressible as a single group with no heading —
+ * that is why there is no separate flat `items` input competing with this one. Supplied already
+ * translated.
+ *
+ * A group whose items are all filtered out hides itself, heading and separator included.
+ */
+interface YuwCommandGroupDto {
+    id: string;
+    label?: string;
+    items: YuwCommandItemDto[];
+}
+
+/** Default match used by both `<yuw-command>` and `<yuw-command-dialog>`, mirroring brain's own
+ * case-insensitive substring filter. Exported so the dialog forwards one shared default rather
+ * than declaring a second one that could drift. */
+declare const yuwCommandDefaultFilter: CommandFilter;
+/**
+ * Searchable command palette rendering groups of runnable entries.
+ *
+ * Entries come from the `groups` input — no per-entry directives to declare — and are filtered as
+ * the user types. Choosing one runs its own `action` when it has one and always emits
+ * `commandSelected`, so an entry needing wider context than a bare callback is handled by the
+ * parent instead.
+ *
+ * Inputs / Models:
+ * - `groups`: Required entry definitions (`YuwCommandGroupDto[]`), rendered in order. A palette
+ *   with no headings is one group with no `label`.
+ * - `search`: Two-way filter query. Emits `searchChange` as the user types; set it to filter
+ *   programmatically or to reset the palette after running something.
+ * - `disabled`: Blocks the whole palette.
+ * - `filter`: Match predicate `(searchText, query) => boolean`. Defaults to a case-insensitive
+ *   substring match; replace it for fuzzy or accent-insensitive matching. It receives an entry's
+ *   `searchText` (or its `label`), never its `id`.
+ * - `color`: Token palette applied to the subtree via `data-yuw-color`.
+ * - `emptyText`: Message shown when the query matches nothing. User-facing text — the consuming
+ *   app is responsible for providing it translated.
+ * - `searchPlaceholder`: Placeholder of the search field. Same translation contract.
+ * - `class`: Merged onto the palette surface, so a consumer can size it without forking.
+ *
+ * Outputs:
+ * - `commandSelected`: Emits the chosen `YuwCommandItemDto` for every selection, whether or not it
+ *   carried an `action`.
+ *
+ * Usage:
+ * ```html
+ * <yuw-command
+ *   [groups]="groups"
+ *   [(search)]="query"
+ *   emptyText="No results found."
+ *   searchPlaceholder="Type a command…"
+ *   (commandSelected)="run($event)"
+ * />
+ * ```
+ */
+declare class YuwCommandComponent {
+    readonly color: _angular_core.InputSignal<YuwColorDto | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly emptyText: _angular_core.InputSignal<string | undefined>;
+    readonly filter: _angular_core.InputSignal<CommandFilter>;
+    readonly groups: _angular_core.InputSignal<YuwCommandGroupDto[]>;
+    readonly search: _angular_core.ModelSignal<string>;
+    readonly searchPlaceholder: _angular_core.InputSignal<string | undefined>;
+    readonly userClass: _angular_core.InputSignal<string>;
+    readonly commandSelected: _angular_core.OutputEmitterRef<YuwCommandItemDto>;
+    /** Brain matches its filter against each item's `value`, so `value` carries the searchable text
+     * while `id` stays the identity — precomputed here so the template neither calls a method nor
+     * rebuilds the string on every change-detection pass. */
+    protected readonly _groups: _angular_core.Signal<{
+        items: {
+            item: YuwCommandItemDto;
+            searchValue: string;
+        }[];
+        id: string;
+        label?: string;
+    }[]>;
+    protected onSelected(item: YuwCommandItemDto): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwCommandComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwCommandComponent, "yuw-command", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": true; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "search": "searchChange"; "commandSelected": "commandSelected"; }, never, never, true, never>;
+}
+
+/**
+ * `<yuw-command>` hosted in a centred modal — the ⌘K palette shape.
+ *
+ * Wraps the palette rather than re-projecting it, so filtering, grouping and selection behave
+ * identically to the inline component. Two behaviours belong to the modal and are handled here:
+ * the query is cleared whenever the palette closes, so it never reopens still filtered by the last
+ * search; and choosing an entry closes it, since picking *is* the confirmation.
+ *
+ * The opening accelerator is deliberately not bound here. A global hotkey is application policy —
+ * it has to coexist with whatever else the app binds — so the consumer drives `open` from its own
+ * listener. `shortcut` text on the entries is likewise the consumer's, and platform-dependent
+ * (`⌘K` on Apple platforms, `Ctrl+K` elsewhere).
+ *
+ * Inputs / Models:
+ * - `groups`: Required entry definitions (`YuwCommandGroupDto[]`), as `<yuw-command>` takes them.
+ * - `open`: Two-way open/closed state. Drive via `[(open)]` from the trigger or hotkey.
+ * - `search`: Two-way filter query. Reset to `''` on close.
+ * - `closeOnSelect`: Whether choosing an entry closes the palette. Default `true`; set it `false`
+ *   for a palette whose entries toggle state and are expected to be used several times in a row.
+ * - `title`: Accessible name of the modal, rendered visually hidden — a palette shows no heading
+ *   above its search field, but the dialog still needs a name. Required, user-facing text the
+ *   consuming app is responsible for translating.
+ * - `description`: Visually hidden description of the modal, announced after `title`. Same
+ *   translation contract.
+ * - `emptyText`, `searchPlaceholder`, `filter`, `color`: Forwarded to `<yuw-command>` unchanged;
+ *   `filter` shares its default, so the two components always match on the same rule.
+ * - `panelClass`: Extra classes merged onto the modal panel. Use it to widen the palette or lift it
+ *   above centre (`mb-[24vh]`), where palettes are conventionally placed. Prefer a margin over
+ *   `-translate-y`: the panel animates with `zoom-*`, whose keyframes drive `transform`.
+ *   Resizing it needs a **definite width** plus an **`sm:`-prefixed** cap, e.g.
+ *   `w-[650px] max-w-[calc(100vw-2rem)] sm:max-w-[calc(100vw-2rem)]`. Both parts are load-bearing,
+ *   verified by measuring the rendered panel in Chrome:
+ *   - `.cdk-overlay-pane` is `position: absolute` with no width, so it shrink-wraps its content.
+ *     A percentage width (`w-full`) therefore resolves against the *content* width — about 80px —
+ *     not the viewport, and no `max-w-*` can widen it because nothing ever requests more. Only a
+ *     definite `w-[…]` makes the pane size itself.
+ *   - the cap must repeat under the `sm:` variant, because the helm's own cap is `sm:max-w-sm`
+ *     (384px) emitted late in the stylesheet. `twMerge` only collapses classes of the same
+ *     variant, so an unprefixed `max-w-*` leaves `sm:max-w-sm` in place and loses to it above
+ *     640px — the class list looks right while the panel stays 384px wide.
+ *   Use `100vw` rather than `100%` in the cap: a percentage is relative to the shrink-wrapped pane
+ *   again. `min-w-*` is rarely needed, since the `vw` cap already tracks the viewport.
+ *
+ * Outputs:
+ * - `commandSelected`: Emits the chosen entry, after running its own `action`.
+ *
+ * Usage:
+ * ```html
+ * <yuw-command-dialog
+ *   [groups]="groups"
+ *   [(open)]="paletteOpen"
+ *   title="Command palette"
+ *   emptyText="No results found."
+ *   searchPlaceholder="Type a command or search…"
+ *   panelClass="sm:max-w-lg mb-[24vh]"
+ *   (commandSelected)="run($event)"
+ * />
+ * ```
+ */
+declare class YuwCommandDialogComponent {
+    readonly closeOnSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly color: _angular_core.InputSignal<YuwColorDto | undefined>;
+    readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly emptyText: _angular_core.InputSignal<string | undefined>;
+    readonly filter: _angular_core.InputSignal<CommandFilter>;
+    readonly groups: _angular_core.InputSignal<YuwCommandGroupDto[]>;
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly panelClass: _angular_core.InputSignal<string | undefined>;
+    readonly search: _angular_core.ModelSignal<string>;
+    readonly searchPlaceholder: _angular_core.InputSignal<string | undefined>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly commandSelected: _angular_core.OutputEmitterRef<YuwCommandItemDto>;
+    protected readonly _panelClasses: _angular_core.Signal<string>;
+    protected readonly _state: _angular_core.Signal<BrnDialogState>;
+    protected onSelected(item: YuwCommandItemDto): void;
+    protected onStateChanged(state: BrnDialogState): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<YuwCommandDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<YuwCommandDialogComponent, "yuw-command-dialog", never, { "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "search": { "alias": "search"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "open": "openChange"; "search": "searchChange"; "commandSelected": "commandSelected"; }, never, never, true, never>;
+}
+
+export { DATATABLE_ALIGN_CLASS, YUW_PASSWORD_REVEAL_STATES, YUW_SIDEBAR_RAIL_ICON_SIZE, YUW_SIDEBAR_RAIL_PADDING, YUW_SIDEBAR_RAIL_WIDTH, YuwAccordion, YuwAccordionContentComponent, YuwAccordionImports, YuwAccordionItem, YuwAccordionTriggerComponent, YuwAlertActionDirective, YuwAlertComponent, YuwAlertDescriptionDirective, YuwAlertDialogComponent, YuwAlertDialogMediaDirective, YuwAlertDialogTriggerDirective, YuwAlertImports, YuwAlertTitleDirective, YuwAttachmentActionDirective, YuwAttachmentActionsDirective, YuwAttachmentContentDirective, YuwAttachmentDescriptionDirective, YuwAttachmentDirective, YuwAttachmentGroupDirective, YuwAttachmentMediaDirective, YuwAttachmentTitleDirective, YuwAttachmentTriggerDirective, YuwAvatarComponent, YuwBadgeComponent, YuwBreadcrumbComponent, YuwButtonComponent, YuwButtonGroupComponent, YuwButtonGroupContentDirective, YuwCaptionDirective, YuwCardActionDirective, YuwCardContentDirective, YuwCardDescriptionDirective, YuwCardDirective, YuwCardFooterDirective, YuwCardHeaderDirective, YuwCardImports, YuwCardTitleDirective, YuwCheckboxComponent, YuwClassDirective, YuwComboboxComponent, YuwComboboxItemDirective, YuwCommandComponent, YuwCommandDialogComponent, YuwContextMenuCheckboxDirective, YuwContextMenuCheckboxIndicatorComponent, YuwContextMenuDirective, YuwContextMenuGroupDirective, YuwContextMenuImports, YuwContextMenuItemDirective, YuwContextMenuLabelDirective, YuwContextMenuRadioDirective, YuwContextMenuRadioIndicatorComponent, YuwContextMenuSeparatorDirective, YuwContextMenuShortcutDirective, YuwContextMenuSubDirective, YuwContextMenuSubIndicatorComponent, YuwContextMenuSubTriggerDirective, YuwContextMenuTriggerDirective, YuwDatatableComponent, YuwDatatablePaginationDirective, YuwDatatableRowSelect, YuwDatepickerComponent, YuwDialogCloseDirective, YuwDialogComponent, YuwDialogFooterDirective, YuwDialogImports, YuwDialogTriggerDirective, YuwEmptyContentDirective, YuwEmptyDescriptionDirective, YuwEmptyDirective, YuwEmptyHeaderDirective, YuwEmptyImports, YuwEmptyMediaDirective, YuwEmptyTitleDirective, YuwInputAddonImports, YuwInputComponent, YuwInputOtpComponent, YuwItemActionsDirective, YuwItemContentDirective, YuwItemDescriptionDirective, YuwItemDirective, YuwItemFooterDirective, YuwItemGroupDirective, YuwItemHeaderDirective, YuwItemImports, YuwItemMediaDirective, YuwItemSeparatorDirective, YuwItemTitleDirective, YuwLabel, YuwLeftAddonDirective, YuwPaginationComponent, YuwPasswordInputComponent, YuwPopoverComponent, YuwPopoverTriggerDirective, YuwRadioGroupComponent, YuwRightAddonDirective, YuwSearchInputComponent, YuwSheetCloseDirective, YuwSheetComponent, YuwSheetFooterDirective, YuwSheetImports, YuwSheetTriggerDirective, YuwSidebarComponent, YuwSidebarContentDirective, YuwSidebarContentExtraDirective, YuwSidebarFooterDirective, YuwSidebarFooterExtraDirective, YuwSidebarGroupContentDirective, YuwSidebarGroupDirective, YuwSidebarGroupLabelDirective, YuwSidebarHeaderDirective, YuwSidebarInsetDirective, YuwSidebarMenuAvatarButtonDirective, YuwSidebarMenuBadgeDirective, YuwSidebarMenuButtonDirective, YuwSidebarMenuDirective, YuwSidebarMenuItemDirective, YuwSidebarMenuSubButtonDirective, YuwSidebarMenuSubDirective, YuwSidebarMenuSubItemDirective, YuwSidebarRailDirective, YuwSidebarRailService, YuwSidebarSeparatorDirective, YuwSidebarSubmenuService, YuwSidebarTriggerComponent, YuwSidebarWrapperDirective, YuwSkeletonDirective, YuwSpinnerComponent, YuwSwitchComponent, YuwTBodyDirective, YuwTFootDirective, YuwTHeadDirective, YuwTabPanelDirective, YuwTableContainerDirective, YuwTableDirective, YuwTableImports, YuwTabsComponent, YuwTdDirective, YuwTextareaComponent, YuwThDirective, YuwToasterComponent, YuwTooltipDirective, YuwTrDirective, YuwValueAccessorBase, buildInputOtpGroups, cn, datatableCellVariants, datatableContainerVariants, datatableHeadVariants, datatableHeaderCellVariants, datatableRowVariants, getPaginationRange, provideValueAccessor, totalInputOtpLength, yuwCommandDefaultFilter };
+export type { YuwAlertDialogSizeDto, YuwAlertVariantDto, YuwAvatarGroupItemDto, YuwAvatarSizeDto, YuwBreadcrumbItemDto, YuwButtonGroupClickDto, YuwButtonGroupItemDto, YuwColorDto, YuwComboboxItemContext, YuwComboboxOptionDto, YuwComboboxValue, YuwCommandGroupDto, YuwCommandItemDto, YuwDatatableAlign, YuwDatatableAppearanceDto, YuwDatatableColumnDef, YuwDatepickerModeDto, YuwDatepickerValue, YuwFieldSizeDto, YuwInputModeDto, YuwInputOtpGroupDto, YuwInputOtpModeDto, YuwInputTypeDto, YuwPaginationRangeItem, YuwPaginationSizeDto, YuwPasswordRevealStateDto, YuwPopoverAlignDto, YuwRadioOptionDto, YuwSearchInputCollapseFromDto, YuwSheetScrollStrategyDto, YuwSheetSideDto, YuwSidebarAvatarDto, YuwSidebarCollapsibleDto, YuwSidebarContentDto, YuwSidebarGroupDto, YuwSidebarItemClickDto, YuwSidebarItemDto, YuwSidebarSideDto, YuwSidebarSubItemDto, YuwSidebarVariantDto, YuwSwitchSizeDto, YuwTabItemDto, YuwTabsActivationModeDto, YuwTabsOrientationDto, YuwTabsVariantDto, YuwTextFieldContract, YuwToasterPositionDto, YuwToasterThemeDto, YuwTooltipPositionDto };