codexly-ui 0.22.1 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexly-ui",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "Standalone, signal-based Angular UI component library for Codexly, styled with Tailwind CSS.",
   "keywords": [
     "angular",

package/types/codexly-ui.d.ts

@@ -4478,11 +4478,53 @@ declare class ClxCartSummaryDrawer {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxCartSummaryDrawer, "clx-cart-summary-drawer", never, {}, {}, never, never, true, never>;
 }
 
+/** One row of clx-search's suggestions panel: a product (image, price as meta), a category / brand
+ *  shortcut (icon) or a past search. `data` is whatever the host needs back on select. */
+interface ClxSearchSuggestion {
+    id: string;
+    label: string;
+    sublabel?: string;
+    /** Thumbnail URL (products). */
+    image?: string;
+    /** Material Symbol when there's no image ("category", "history"…). */
+    icon?: string;
+    /** Right-aligned text, e.g. a price. */
+    meta?: string;
+    data?: unknown;
+}
+interface ClxSearchSuggestionGroup {
+    /** Identifies the group on select ("products", "categories"…). */
+    key: string;
+    title: string;
+    items: ClxSearchSuggestion[];
+}
+/** What the host feeds clx-search's panel for the current text. */
+interface ClxSearchSuggestions {
+    groups: ClxSearchSuggestionGroup[];
+    /** "¿Quisiste decir …?" — clicking it searches it. */
+    correction?: string | null;
+    /** Total results for the text — shows "Ver los N resultados". */
+    total?: number | null;
+}
+interface ClxSearchSuggestionSelect {
+    group: string;
+    item: ClxSearchSuggestion;
+}
+
 /** Storefront search bar — same color/size/CVA conventions as ClxInputComponent, but styled as
  *  one continuous pill (input fused with a solid search button) rather than a bordered field with
- *  a detached button, matching how e-commerce header search boxes are typically laid out. */
+ *  a detached button, matching how e-commerce header search boxes are typically laid out.
+ *
+ *  Optional autocomplete: the host listens to (queryChange) — the text, debounced, once it has
+ *  `minChars` — and feeds [suggestions] back (product rows with image and price, shortcuts, past
+ *  searches, a "¿Quisiste decir…?" correction, the result total). The panel opens under the bar,
+ *  supports ↑ ↓ Enter Esc, and reports picks through (suggestionSelect); Enter without a picked row,
+ *  the button, the correction and "Ver todos" emit (search). With [openOnFocus] the panel also shows
+ *  for an empty box (e.g. recent searches). */
 declare class ClxSearchComponent implements ControlValueAccessor {
     private readonly _themeSvc;
+    private readonly _el;
+    private readonly _sso;
     readonly color: _angular_core.InputSignal<ClxColorInput | undefined>;
     protected readonly _color: _angular_core.Signal<ClxColorInput>;
     /** Overrides only the search button's text color — see ClxButtonComponent's textColor input. */
@@ -4495,16 +4537,40 @@ declare class ClxSearchComponent implements ControlValueAccessor {
     readonly value: _angular_core.InputSignal<string>;
     /** Disabled state for standalone use (without FormControl) */
     readonly disabled: _angular_core.InputSignal<boolean>;
+    /** Autocomplete content for the current text; null = no panel. */
+    readonly suggestions: _angular_core.InputSignal<ClxSearchSuggestions | null>;
+    /** The host is fetching suggestions. */
+    readonly loading: _angular_core.InputSignal<boolean>;
+    /** (queryChange) waits this long after the last keystroke. */
+    readonly debounceMs: _angular_core.InputSignal<number>;
+    /** (queryChange) only from this many characters (0 = also for an empty box). */
+    readonly minChars: _angular_core.InputSignal<number>;
+    /** Show the panel when focusing an empty box (recent searches…). */
+    readonly openOnFocus: _angular_core.InputSignal<boolean>;
     readonly search: _angular_core.OutputEmitterRef<string>;
+    /** Debounced text for the host to fetch suggestions for ('' when cleared). */
+    readonly queryChange: _angular_core.OutputEmitterRef<string>;
+    readonly suggestionSelect: _angular_core.OutputEmitterRef<ClxSearchSuggestionSelect>;
     protected readonly _inputId: string;
     readonly _value: _angular_core.WritableSignal<string>;
     private readonly _cvaDisabled;
     private _cvaConnected;
     private readonly _cardDisabled;
+    private readonly _focused;
+    private readonly _dismissed;
+    private readonly _active;
+    protected readonly _panelWidth: _angular_core.WritableSignal<number>;
+    private _debounce?;
     protected readonly _disabled: _angular_core.Signal<boolean>;
+    readonly _scrollStrategy: _angular_cdk_overlay.RepositionScrollStrategy;
+    readonly _positions: ConnectedPosition[];
+    /** Flat list of the panel's rows, for ↑ ↓. */
+    private readonly _rows;
+    protected readonly _panelOpen: _angular_core.Signal<boolean>;
     private readonly _valueEffect;
     private _onChange;
     private _onTouched;
+    constructor();
     protected readonly _sizeConfig: _angular_core.Signal<{
         input: string;
         label: string;
@@ -4518,6 +4584,7 @@ declare class ClxSearchComponent implements ControlValueAccessor {
         padDefaultR: string;
     }>;
     protected readonly _buttonSize: _angular_core.Signal<"xs" | "sm" | "md" | "lg">;
+    protected readonly _accentText: _angular_core.Signal<string>;
     protected readonly _wrapperClass: _angular_core.Signal<string>;
     protected readonly _inputClass: _angular_core.Signal<string>;
     writeValue(val: string): void;
@@ -4525,10 +4592,18 @@ declare class ClxSearchComponent implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(disabled: boolean): void;
     protected _handleInput(event: Event): void;
+    protected _handleFocus(): void;
     protected _handleBlur(): void;
+    protected _handleKeydown(event: KeyboardEvent): void;
+    protected _isActive(group: string, item: ClxSearchSuggestion): boolean;
+    protected _activate(group: string, item: ClxSearchSuggestion): void;
+    protected _select(group: string, item: ClxSearchSuggestion): void;
+    protected _searchFor(text: string): void;
+    protected _close(): void;
     protected _handleSubmit(): void;
+    private _emitQuery;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClxSearchComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxSearchComponent, "clx-search", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "buttonTextColor": { "alias": "buttonTextColor"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "buttonLabel": { "alias": "buttonLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "search": "search"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClxSearchComponent, "clx-search", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "buttonTextColor": { "alias": "buttonTextColor"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "buttonLabel": { "alias": "buttonLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "debounceMs": { "alias": "debounceMs"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "openOnFocus": { "alias": "openOnFocus"; "required": false; "isSignal": true; }; }, { "search": "search"; "queryChange": "queryChange"; "suggestionSelect": "suggestionSelect"; }, never, never, true, never>;
 }
 
 declare const CLX_TEXT_LABEL = "text-clx-text-label";
@@ -4884,4 +4959,4 @@ declare class ClxToastService {
 }
 
 export { CLX_ADDON_BORDER, CLX_ADDON_TEXT, CLX_ALERT_OPTIONS, CLX_ALERT_RESOLVE, CLX_BG_ADDON, CLX_BG_DISABLED, CLX_BG_ICON_WRAP, CLX_BG_SECTION, CLX_BG_SURFACE, CLX_BORDER_DEFAULT, CLX_BORDER_DISABLED, CLX_BORDER_MEDIUM, CLX_COLOR_HEX, CLX_COLOR_HEX_100, CLX_COLOR_MAP, CLX_FONT_CATALOG, CLX_MODAL_ANIM_CONFIG, CLX_MODAL_DATA, CLX_MODAL_REF, CLX_OPTION_DISABLED, CLX_PLACEHOLDER, CLX_RADIO_GROUP, CLX_RADIUS_MAP, CLX_TEXT_BODY, CLX_TEXT_DISABLED, CLX_TEXT_HEADING, CLX_TEXT_HINT, CLX_TEXT_IDLE, CLX_TEXT_INPUT, CLX_TEXT_LABEL, CLX_TEXT_OPTION, CLX_TEXT_SUBTITLE, CLX_TEXT_TITLE, CLX_THEME_CONFIG, CLX_THEME_DEFAULTS, CLX_TOAST_DEFAULTS, ClxAlertComponent, ClxAlertListComponent, ClxAlertService, ClxAnimateDirective, ClxAnimateGroupDirective, ClxAnimateService, ClxAppLayoutComponent, ClxAvatarComponent, ClxBadgeComponent, ClxBrandComponent, ClxButtonComponent, ClxButtonGroupComponent, ClxCardBodyDirective, ClxCardComponent, ClxCardExpiryInputComponent, ClxCardFooterDirective, ClxCardHeaderActionsDirective, ClxCardHeaderDirective, ClxCardNumberInputComponent, ClxCardValidators, ClxCarouselComponent, ClxCarouselDirective, ClxCartComponent, ClxCartSummaryDrawer, ClxCellDirective, ClxCheckboxComponent, ClxCollapseComponent, ClxColorPickerComponent, ClxColumnDefDirective, ClxCopyTextComponent, ClxDateRangePickerComponent, ClxDatepickerComponent, ClxDrawerComponent, ClxDrawerService, ClxEditorComponent, ClxEditorImageModalComponent, ClxEditorLinkModalComponent, ClxFabComponent, ClxFilterPanelComponent, ClxHeaderCellDirective, ClxIconComponent, ClxInputComponent, ClxListComponent, ClxListItemComponent, ClxMaintenanceBannerComponent, ClxMenuComponent, ClxMenuItemComponent, ClxMenuItemTrailingDirective, ClxModalComponent, ClxModalService, ClxNativeOverlayService, ClxNavGroupComponent, ClxNotificationComponent, ClxNumberComponent, ClxOtpComponent, ClxPageEmptyComponent, ClxPageHeaderComponent, ClxPageHeaderTitleDirective, ClxPageMaintenanceComponent, ClxPageNotFoundComponent, ClxPageServerErrorComponent, ClxPageUnauthorizedComponent, ClxPaginationComponent, ClxProductBadgesComponent, ClxProductComponent, ClxProductDetailComponent, ClxProductQuickViewComponent, ClxProductTagService, ClxProfileComponent, ClxProgressBarComponent, ClxRadioComponent, ClxRadioGroupComponent, ClxRankedListComponent, ClxRatingComponent, ClxSearchComponent, ClxSelectComponent, ClxSkeletonComponent, ClxSliderComponent, ClxSocialIconComponent, ClxSpinnerComponent, ClxStatCardComponent, ClxStepComponent, ClxStepperComponent, ClxSwitchComponent, ClxTabDirective, ClxTableActionsComponent, ClxTableComponent, ClxTableProductCellComponent, ClxTableProgressCellComponent, ClxTableStatusCellComponent, ClxTabsComponent, ClxTagComponent, ClxTextareaComponent, ClxThemeService, ClxTimelineComponent, ClxTimelineItemComponent, ClxTimepickerComponent, ClxToastComponent, ClxToastContainerComponent, ClxToastService, ClxTooltipComponent, ClxTooltipDirective, ClxTreeComponent, ClxUploadComponent, ClxWidgetCardComponent, ClxWishlistComponent, ClxWizardComponent, TIMEPICKER_SIZE_MAP, detectClxCardBrand, formatClxTime, formatClxWindow, isClxCardExpired, parseColorInput, provideCodexlyTheme, resolveColor, resolveContainerRadius, resolveRadius };
-export type { ClxAlertButtonOptions, ClxAlertListItem, ClxAlertOptions, ClxAlertResult, ClxAlertSeverity, ClxAlertType, ClxAnimateAttentionSeeker, ClxAnimateBackEntrance, ClxAnimateBackExit, ClxAnimateBouncingEntrance, ClxAnimateBouncingExit, ClxAnimateConfig, ClxAnimateDefaults, ClxAnimateEvent, ClxAnimateFadingEntrance, ClxAnimateFadingExit, ClxAnimateFlipper, ClxAnimateLightspeed, ClxAnimateName, ClxAnimateRotatingEntrance, ClxAnimateRotatingExit, ClxAnimateSlidingEntrance, ClxAnimateSlidingExit, ClxAnimateSpecial, ClxAnimateTrigger, ClxAnimateZoomingEntrance, ClxAnimateZoomingExit, ClxAvatarContentType, ClxBadgeVariant, ClxBrandSize, ClxButtonColor, ClxButtonGroupShape, ClxButtonVariant, ClxCardBrand, ClxCardPadding, ClxCardShadow, ClxCardTitleZoneStyle, ClxCardVariant, ClxCarouselAspectRatio, ClxCarouselConfig, ClxCartItem, ClxCartSummaryData, ClxCellContext, ClxCheckboxVariant, ClxCollapseDivider, ClxCollapseSize, ClxColor, ClxColorInput, ClxColorPickerFormat, ClxColorPickerSize, ClxColorResolved, ClxColorTokens, ClxCouponResult, ClxDateRange, ClxDateRangePickerSize, ClxDateRangePickerStatus, ClxDatepickerSize, ClxDatepickerStatus, ClxDrawerButtonOptions, ClxDrawerConfig, ClxDrawerPosition, ClxDrawerRef, ClxDrawerSize, ClxEditorSize, ClxEditorTool, ClxEditorToolbarGroup, ClxExistingFile, ClxFabItem, ClxFabPosition, ClxFilterChangeEvent, ClxFilterField, ClxFilterFieldType, ClxFilterOption, ClxFilterValue, ClxFilterValues, ClxFontFamily, ClxFontOption, ClxFontWeight, ClxFormControlsTheme, ClxInputSize, ClxInputStatus, ClxInputType, ClxListItem, ClxListItemLabelZoneStyle, ClxListSize, ClxListVariant, ClxModalButtonOptions, ClxModalConfig, ClxModalRef, ClxModalSize, ClxNavZoneStyle, ClxNotificationItem, ClxNotificationSeverity, ClxNotificationSeverityColors, ClxNotificationSize, ClxNotificationTheme, ClxNumberSize, ClxNumberVariant, ClxOtpSize, ClxPageChangeEvent, ClxPageHeaderTextSize, ClxPageHeaderZoneStyle, ClxPageSizeChangeEvent, ClxPaginationSize, ClxPaginationTheme, ClxProduct, ClxProductDescription, ClxProductDetailData, ClxProductLayout, ClxProductQuickViewData, ClxProductQuickViewResult, ClxProductSize, ClxProductSpec, ClxProfileMenuItem, ClxProgressBarSegment, ClxProgressBarSize, ClxProgressBarVariant, ClxRadioVariant, ClxRankedListItem, ClxResolvedCardTitleZoneStyle, ClxResolvedListItemLabelZoneStyle, ClxResolvedNavZoneStyle, ClxResolvedNotificationStyle, ClxResolvedPageHeaderZoneStyle, ClxResolvedPaginationStyle, ClxResolvedTableStyle, ClxResolvedTabsStyle, ClxResolvedTimelineTitleZoneStyle, ClxResolvedWizardStyle, ClxReview, ClxRippleItem, ClxSelectOption, ClxSelectSize, ClxShade, ClxShape, ClxSize, ClxSkeletonVariant, ClxSliderSize, ClxSocialPlatform, ClxSpecOption, ClxSpecType, ClxSpinnerColor, ClxSpinnerVariant, ClxStatMetric, ClxStepperOrientation, ClxStepperSize, ClxStepperStatus, ClxStepperStep, ClxTabItem, ClxTableColumn, ClxTablePageEvent, ClxTableSelectionEvent, ClxTableShadow, ClxTableSort, ClxTableSortEvent, ClxTableTheme, ClxTabsTheme, ClxTagBadge, ClxTagContext, ClxTagKind, ClxTagPosition, ClxTagShape, ClxTagSize, ClxTagStyle, ClxTagVariant, ClxTextareaResize, ClxTextareaSize, ClxTextareaStatus, ClxThemeConfig, ClxThemeMode, ClxTimelineLineStyle, ClxTimelineMode, ClxTimelineSize, ClxTimelineTitleZoneStyle, ClxTimepickerSize, ClxTimepickerStatus, ClxToastAction, ClxToastEntry, ClxToastOptions, ClxToastPosition, ClxToastType, ClxTooltipPosition, ClxTooltipSize, ClxTreeExpandEvent, ClxTreeNode, ClxTreeSelectEvent, ClxTreeSize, ClxTreeVariant, ClxTrendDirection, ClxUploadError, ClxUploadItemAction, ClxUploadItemActionResolver, ClxUploadPreviewItem, ClxUploadSize, ClxVariation, ClxWidgetCardState, ClxWidgetMenuAction, ClxWishlistItem, ClxWishlistPageChangeEvent, ClxWizardColor, ClxWizardOrientation, ClxWizardStepStatus, ClxWizardTheme, NativeOverlayRef, SparkPoint };
+export type { ClxAlertButtonOptions, ClxAlertListItem, ClxAlertOptions, ClxAlertResult, ClxAlertSeverity, ClxAlertType, ClxAnimateAttentionSeeker, ClxAnimateBackEntrance, ClxAnimateBackExit, ClxAnimateBouncingEntrance, ClxAnimateBouncingExit, ClxAnimateConfig, ClxAnimateDefaults, ClxAnimateEvent, ClxAnimateFadingEntrance, ClxAnimateFadingExit, ClxAnimateFlipper, ClxAnimateLightspeed, ClxAnimateName, ClxAnimateRotatingEntrance, ClxAnimateRotatingExit, ClxAnimateSlidingEntrance, ClxAnimateSlidingExit, ClxAnimateSpecial, ClxAnimateTrigger, ClxAnimateZoomingEntrance, ClxAnimateZoomingExit, ClxAvatarContentType, ClxBadgeVariant, ClxBrandSize, ClxButtonColor, ClxButtonGroupShape, ClxButtonVariant, ClxCardBrand, ClxCardPadding, ClxCardShadow, ClxCardTitleZoneStyle, ClxCardVariant, ClxCarouselAspectRatio, ClxCarouselConfig, ClxCartItem, ClxCartSummaryData, ClxCellContext, ClxCheckboxVariant, ClxCollapseDivider, ClxCollapseSize, ClxColor, ClxColorInput, ClxColorPickerFormat, ClxColorPickerSize, ClxColorResolved, ClxColorTokens, ClxCouponResult, ClxDateRange, ClxDateRangePickerSize, ClxDateRangePickerStatus, ClxDatepickerSize, ClxDatepickerStatus, ClxDrawerButtonOptions, ClxDrawerConfig, ClxDrawerPosition, ClxDrawerRef, ClxDrawerSize, ClxEditorSize, ClxEditorTool, ClxEditorToolbarGroup, ClxExistingFile, ClxFabItem, ClxFabPosition, ClxFilterChangeEvent, ClxFilterField, ClxFilterFieldType, ClxFilterOption, ClxFilterValue, ClxFilterValues, ClxFontFamily, ClxFontOption, ClxFontWeight, ClxFormControlsTheme, ClxInputSize, ClxInputStatus, ClxInputType, ClxListItem, ClxListItemLabelZoneStyle, ClxListSize, ClxListVariant, ClxModalButtonOptions, ClxModalConfig, ClxModalRef, ClxModalSize, ClxNavZoneStyle, ClxNotificationItem, ClxNotificationSeverity, ClxNotificationSeverityColors, ClxNotificationSize, ClxNotificationTheme, ClxNumberSize, ClxNumberVariant, ClxOtpSize, ClxPageChangeEvent, ClxPageHeaderTextSize, ClxPageHeaderZoneStyle, ClxPageSizeChangeEvent, ClxPaginationSize, ClxPaginationTheme, ClxProduct, ClxProductDescription, ClxProductDetailData, ClxProductLayout, ClxProductQuickViewData, ClxProductQuickViewResult, ClxProductSize, ClxProductSpec, ClxProfileMenuItem, ClxProgressBarSegment, ClxProgressBarSize, ClxProgressBarVariant, ClxRadioVariant, ClxRankedListItem, ClxResolvedCardTitleZoneStyle, ClxResolvedListItemLabelZoneStyle, ClxResolvedNavZoneStyle, ClxResolvedNotificationStyle, ClxResolvedPageHeaderZoneStyle, ClxResolvedPaginationStyle, ClxResolvedTableStyle, ClxResolvedTabsStyle, ClxResolvedTimelineTitleZoneStyle, ClxResolvedWizardStyle, ClxReview, ClxRippleItem, ClxSearchSuggestion, ClxSearchSuggestionGroup, ClxSearchSuggestionSelect, ClxSearchSuggestions, ClxSelectOption, ClxSelectSize, ClxShade, ClxShape, ClxSize, ClxSkeletonVariant, ClxSliderSize, ClxSocialPlatform, ClxSpecOption, ClxSpecType, ClxSpinnerColor, ClxSpinnerVariant, ClxStatMetric, ClxStepperOrientation, ClxStepperSize, ClxStepperStatus, ClxStepperStep, ClxTabItem, ClxTableColumn, ClxTablePageEvent, ClxTableSelectionEvent, ClxTableShadow, ClxTableSort, ClxTableSortEvent, ClxTableTheme, ClxTabsTheme, ClxTagBadge, ClxTagContext, ClxTagKind, ClxTagPosition, ClxTagShape, ClxTagSize, ClxTagStyle, ClxTagVariant, ClxTextareaResize, ClxTextareaSize, ClxTextareaStatus, ClxThemeConfig, ClxThemeMode, ClxTimelineLineStyle, ClxTimelineMode, ClxTimelineSize, ClxTimelineTitleZoneStyle, ClxTimepickerSize, ClxTimepickerStatus, ClxToastAction, ClxToastEntry, ClxToastOptions, ClxToastPosition, ClxToastType, ClxTooltipPosition, ClxTooltipSize, ClxTreeExpandEvent, ClxTreeNode, ClxTreeSelectEvent, ClxTreeSize, ClxTreeVariant, ClxTrendDirection, ClxUploadError, ClxUploadItemAction, ClxUploadItemActionResolver, ClxUploadPreviewItem, ClxUploadSize, ClxVariation, ClxWidgetCardState, ClxWidgetMenuAction, ClxWishlistItem, ClxWishlistPageChangeEvent, ClxWizardColor, ClxWizardOrientation, ClxWizardStepStatus, ClxWizardTheme, NativeOverlayRef, SparkPoint };