@acorex/components 20.1.20 → 20.1.22

package/action-sheet/index.d.ts

@@ -93,7 +93,26 @@ declare class AXActionSheetComponent extends MXBaseComponent implements OnInit,
     private snapToFinalPosition;
     private heightCalculator;
     protected handleAttched(ref: CdkPortalOutletAttachedRef): void;
+    /**
+     * Handles click events on action sheet items.
+     * This method is called when a user clicks on an action sheet item. It closes the action sheet
+     * with the clicked item as the result data and executes the item's onClick callback if provided.
+     *
+     * @param item - The action sheet item that was clicked. Contains the item's data and optional onClick callback.
+     * @returns void
+     */
     onItemClick(item: AXActionSheetItem): void;
+    /**
+     * Closes the action sheet with optional result data.
+     * This method initiates the closing animation of the action sheet and eventually closes the dialog.
+     * The closing process includes a height animation and cleanup of event listeners.
+     *
+     * @param e - The result data to pass when closing the action sheet. Can be any value including null.
+     *            If an AXActionSheetItem is passed, it represents the selected item.
+     * @param isUserInteraction - Whether the close action was triggered by user interaction (default: true).
+     *                           This affects how the action sheet handles accessibility and event tracking.
+     * @returns void
+     */
     close(e?: any, isUserInteraction?: boolean): void;
     /**
      *  @ignore
@@ -117,7 +136,44 @@ declare class AXActionSheetService {
     private dialog;
     private readonly actionSheetEvent;
     actionSheetEvent$: rxjs.Observable<AXActionSheetEvent>;
+    /**
+     * Opens an action sheet with the specified configuration.
+     * This method creates and displays an action sheet component with the provided options.
+     * The action sheet will slide up from the bottom of the screen and can be dismissed
+     * by tapping outside, pressing escape, or calling the close method.
+     *
+     * @param config - The configuration object that defines the action sheet's appearance and behavior.
+     *                 Must include at least a title or content property. Will be merged with default config.
+     * @param isUserInteraction - Whether the action sheet is opened by user interaction (default: true).
+     *                           This affects how the action sheet handles accessibility and focus management.
+     * @returns A promise that resolves to a dialog reference containing methods to control the action sheet.
+     *          The reference includes methods like close() and a closed observable for tracking dialog state.
+     * @example
+     * ```typescript
+     * const dialogRef = await actionSheetService.open({
+     *   title: 'Choose an option',
+     *   items: [
+     *     { text: 'Option 1', value: 'opt1' },
+     *     { text: 'Option 2', value: 'opt2' }
+     *   ]
+     * });
+     *
+     * dialogRef.closed.subscribe(result => {
+     *   console.log('Action sheet closed with:', result.data);
+     * });
+     * ```
+     */
     open(config: AXActionSheetConfig, isUserInteraction?: boolean): Promise<AXActionSheetDialogRef>;
+    /**
+     * Sets the current state of action sheet events.
+     * This method is used internally to track action sheet lifecycle events such as open, close,
+     * drag start, drag end, and full screen transitions. It emits events through the actionSheetEvent$
+     * observable for external subscribers to monitor action sheet state changes.
+     *
+     * @param event - The action sheet event to emit. Contains information about the event type,
+     *               associated data, user interaction status, and dialog reference.
+     * @returns void
+     */
     setActionSheetEventState(event: AXActionSheetEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXActionSheetService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXActionSheetService>;

package/alert/index.d.ts

@@ -73,7 +73,7 @@ declare class AXAlertComponent extends MXColorComponent {
     /**
      * Removes the alert from the container after a transition effect.
      *
-     *  @ignore
+     * @returns void - No return value. The alert is removed from the DOM and the onClosed event is emitted.
      */
     close(): void;
     /**

package/avatar/index.d.ts

@@ -10,12 +10,14 @@ declare class AXAvatarGroupComponent {
 
 /**
  * The Avatar component displays a user's profile image or initials, typically used for user identification.
+ * It supports multiple content types including text, icons, images, and badges.
  *
  * @category Components
  */
 declare class AXAvatarComponent extends MXColorComponent {
     /**
-     *  @ignore
+     * Content children for avatar content (ax-image, ax-icon, ax-text).
+     * Used internally to determine if fallback SVG should be shown.
      */
     protected children: i0.Signal<readonly QueryList<unknown>[]>;
     /**
@@ -25,18 +27,23 @@ declare class AXAvatarComponent extends MXColorComponent {
      */
     size: i0.ModelSignal<number>;
     /**
-     * Specifies the visual style of the avatar.
+     * Specifies the visual style of the avatar's corners.
      *
      * @defaultValue 'rounded'
      */
     shape: i0.InputSignal<"sharp" | "soft" | "rounded">;
+    /**
+     * Specifies the visual style of the avatar appearance.
+     *
+     * @defaultValue 'solid'
+     */
     look: i0.InputSignal<"solid" | "twotone">;
     /**
-     *  @ignore
+     * @ignore
      */
     private get __hostClass();
     /**
-     *  @ignore
+     * @ignore
      */
     private get __hostStyle();
     static ɵfac: i0.ɵɵFactoryDeclaration<AXAvatarComponent, never>;

package/breadcrumbs/index.d.ts

@@ -20,8 +20,18 @@ interface AXBreadcrumbsItems {
  * @category Components
  */
 declare class AXBreadCrumbsComponent extends MXBaseComponent implements AfterViewInit {
+    /**
+     * Content child template for custom divider between breadcrumb items.
+     */
     protected _divider: i0.Signal<TemplateRef<any>>;
+    /**
+     * View child template for the divider template.
+     */
     dividerTemplate: i0.Signal<TemplateRef<any>>;
+    /**
+     * Scrolls the breadcrumbs container to the rightmost position after view initialization.
+     * This ensures that the most recent breadcrumb items are visible when there are many items.
+     */
     ngAfterViewInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXBreadCrumbsComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AXBreadCrumbsComponent, "ax-breadcrumbs", never, {}, {}, ["_divider"], ["ax-breadcrumbs-item"], true, never>;
@@ -33,13 +43,17 @@ declare class AXBreadCrumbsComponent extends MXBaseComponent implements AfterVie
  * @category Components
  */
 declare class AXBreadCrumbsItemComponent extends MXInteractiveComponent {
+    /**
+     * Reference to the parent breadcrumbs component.
+     */
     _parent: AXBreadCrumbsComponent;
     /**
      * Indicates whether this breadcrumb item is the current active item.
      */
     active: boolean;
     /**
-     *  @ignore
+     * Host binding for CSS classes based on component state.
+     * Applies 'ax-state-active' when active is true and 'ax-state-disabled' when disabled is true.
      */
     private get __hostClass();
     static ɵfac: i0.ɵɵFactoryDeclaration<AXBreadCrumbsItemComponent, never>;

package/calendar/index.d.ts

@@ -295,18 +295,31 @@ declare class AXCalendarComponent extends AXCalendarComponent_base implements Af
      */
     protected _handleGoToday(): void;
     /**
-     * Navigates to the next item.
-     * @ignore
+     * Navigates forward in the calendar based on the current active view and the configured count.
+     *
+     * Behavior by view:
+     * - day view: advances by count months
+     * - month view: advances by count years
+     * - year view: advances by 10 × count years
+     *
+     * @returns void
      */
     next(): void;
     /**
-     * Navigates to the previous item.
-     * @ignore
+     * Navigates backward in the calendar based on the current active view and the configured count.
+     *
+     * Behavior by view:
+     * - day view: goes back by count months
+     * - month view: goes back by count years
+     * - year view: goes back by 10 × count years
+     *
+     * @returns void
      */
     prev(): void;
     /**
      * Sets focus to the currently selected calendar slot or the first available slot.
-     * @ignore
+     *
+     * @returns void
      */
     focus(): void;
     /**
@@ -314,15 +327,16 @@ declare class AXCalendarComponent extends AXCalendarComponent_base implements Af
      */
     private _navNextPrev;
     /**
-     * Navigates to the current date.
-     * @ignore
+     * Navigates to the current date and emits the navigation event.
+     *
+     * @returns void
      */
     goToday(): void;
     /**
      * Navigates to a specified date and updates the view.
      *
-     * @param date - The date to navigate to, which can be a `Date` object or an `AXDateTime` instance.
-     * @ignore
+     * @param date The date to navigate to, which can be a Date object or an AXDateTime instance.
+     * @returns void
      */
     navTo(date: Date | AXDateTime): void;
     /**

package/check-box/index.d.ts

@@ -63,7 +63,7 @@ declare class AXCheckBoxComponent extends AXCheckBoxComponent_base {
     private get __hostClass();
     protected changeValue(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXCheckBoxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXCheckBoxComponent, "ax-check-box", never, { "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "color": { "alias": "color"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "valueChange": "valueChange"; "onValueChanged": "onValueChanged"; }, ["_labels"], ["ax-label", "ax-form-hint", "ax-validation-rule"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXCheckBoxComponent, "ax-check-box", never, { "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "color": { "alias": "color"; "required": false; }; "value": { "alias": "value"; "required": false; }; "name": { "alias": "name"; "required": false; }; "id": { "alias": "id"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "valueChange": "valueChange"; "onValueChanged": "onValueChanged"; }, ["_labels"], ["ax-label", "ax-form-hint", "ax-validation-rule"], true, never>;
 }
 
 declare class AXCheckBoxModule {

package/circular-progress/index.d.ts

@@ -4,7 +4,8 @@ import { MXColorComponent } from '@acorex/cdk/common';
 
 type AXCircularProgressMode = 'determinate' | 'indeterminate';
 /**
- * The Button is a component which detects user interaction and triggers a corresponding event
+ * Displays the progress of an operation in a circular form. Supports determinate and indeterminate modes,
+ * configurable size and stroke, and color theming.
  *
  * @category Components
  */
@@ -14,29 +15,20 @@ declare class AXCircularProgressComponent extends MXColorComponent {
      */
     circle: _angular_core.Signal<ElementRef<HTMLDivElement>>;
     /**
-     * Defines the current progress of the circular progress component.
-     *
-     * Change progress mode
-     *
+     * Defines the progress calculation mode.
+     * Use 'determinate' to show a specific percentage or 'indeterminate' for ongoing/spinner state.
      */
     mode: _angular_core.InputSignal<AXCircularProgressMode>;
     /**
-     * Defines the current progress of the circular progress component.
-     *
-     * The percentage value to set for the progress.
-     *
+     * The percentage value to set for the progress (0–100).
      */
     progress: _angular_core.ModelSignal<number>;
     /**
-     * Defines the stroke width of the circular progress component.
-     *
-     * The stroke width to be set for the circular progress component.
+     * Stroke width of the circular track, in pixels.
      */
     stroke: _angular_core.ModelSignal<number>;
     /**
-     * Defines the stroke width of the circular progress component.
-     *
-     * Circle size
+     * Overall diameter of the circular progress, in pixels.
      */
     size: _angular_core.ModelSignal<number>;
     /**
@@ -48,15 +40,28 @@ declare class AXCircularProgressComponent extends MXColorComponent {
      */
     private get __hostClass();
     /**
-     * @ignore
+     * Sets the CSS custom properties to reflect the current `size` and `stroke` values.
+     *
+     * Updates `--ax-comp-circular-progress-circle-size` and `--ax-comp-circular-progress-stroke-size` on the circle.
+     *
+     * @returns void - Styles are applied to the circle element when available.
      */
     setCircularSize(): void;
     /**
-     * @ignore
+     * Recalculates and applies the progress arc background based on the current `progress` value.
+     *
+     * Uses a conic-gradient with `--ax-comp-progress-circular-color` and `--ax-comp-progress-circular-line-color`.
+     * The expected range for `progress` is 0–100.
+     *
+     * @returns void - Styles are applied to the circle element when available.
      */
     updateProgress(): void;
     /**
-     * @ignore
+     * Applies a default visual state for the indeterminate mode when no explicit `progress` is set.
+     *
+     * If `mode` is 'indeterminate' and `progress` is not set, it sets `progress` to 65 to render a visible arc.
+     *
+     * @returns void
      */
     setIndeterminateMode(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXCircularProgressComponent, never>;

package/collapse/index.d.ts

@@ -143,17 +143,20 @@ declare class AXCollapseComponent extends AXCollapseComponent_base {
     handleHeaderClick(e: MouseEvent): void;
     /**
      * Expands the collapse component.
-     *  @ignore
+     *
+     * @returns void - No return value. Sets `isCollapsed` to false and expands the body.
      */
     open(): void;
     /**
      * Collapses the collapse component.
-     * @ignore
+     *
+     * @returns void - No return value. Sets `isCollapsed` to true and hides the body.
      */
     close(): void;
     /**
      * Toggles the collapse state between expanded and collapsed.
-     * @ignore
+     *
+     * @returns void - No return value. Flips the `isCollapsed` state.
      */
     toggle(): void;
     /**

package/color-palette/index.d.ts

@@ -282,7 +282,7 @@ declare class AXColorPalleteComponent extends MXValueComponent<string> {
      */
     private get __hostDisabled();
     static ɵfac: i0.ɵɵFactoryDeclaration<AXColorPalleteComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXColorPalleteComponent, "ax-color-palette", never, { "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; "state": { "alias": "state"; "required": false; }; "name": { "alias": "name"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "valueChange": "valueChange"; "stateChange": "stateChange"; "onValueChanged": "onValueChanged"; "readonlyChange": "readonlyChange"; "disabledChange": "disabledChange"; }, ["_children"], ["ax-header", "ax-color-palette-preview", "ax-color-palette-picker", "ax-color-palette-swatches", "ax-color-palette-favorite", "ax-color-palette-input", "ax-footer"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXColorPalleteComponent, "ax-color-palette", never, { "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "value": { "alias": "value"; "required": false; }; "state": { "alias": "state"; "required": false; }; "name": { "alias": "name"; "required": false; }; }, { "onBlur": "onBlur"; "onFocus": "onFocus"; "valueChange": "valueChange"; "stateChange": "stateChange"; "onValueChanged": "onValueChanged"; "readonlyChange": "readonlyChange"; "disabledChange": "disabledChange"; }, ["_children"], ["ax-header", "ax-color-palette-preview", "ax-color-palette-picker", "ax-color-palette-swatches", "ax-color-palette-favorite", "ax-color-palette-input", "ax-footer"], true, never>;
 }
 
 declare class AXColorPaletteModule {

package/comment/index.d.ts

@@ -17,7 +17,7 @@ import * as i7 from '@angular/common';
 declare class AXCommentContainerComponent {
     private document;
     private platformID;
-    scrollToRelpy(id: string): void;
+    scrollToReply(id: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXCommentContainerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AXCommentContainerComponent, "ax-comment-container", never, {}, {}, never, ["*"], true, never>;
 }
@@ -32,13 +32,13 @@ declare class AxCommentItemComponent {
      *  @ignore
      */
     protected avatar: i0.Signal<AXAvatarComponent>;
-    protected collaps: i0.Signal<AXCollapseComponent>;
+    protected collapse: i0.Signal<AXCollapseComponent>;
     replyCount: i0.InputSignal<number>;
     /**
      *  @ignore
      */
     constructor();
-    toggleCollaps(): void;
+    toggleCollapse(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AxCommentItemComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AxCommentItemComponent, "ax-comment-item", never, { "replyCount": { "alias": "replyCount"; "required": false; "isSignal": true; }; }, {}, ["avatar"], ["ax-avatar", "ax-title", "ax-comment-date", "ax-comment-menu-options", "ax-content", "ax-comment-like", "ax-comment-reply-text", "ax-comment-item", "ax-comment-reply-more"], true, never>;
 }

package/cron-job/index.d.ts

@@ -225,7 +225,7 @@ declare class AXCronJobContainerComponent extends MXInputBaseValueComponent<stri
         look: AXTabLook;
         location: AXTabLocation;
     }>;
-    onGetModel(): void;
+    protected onGetModel(): void;
     protected internalValueChanged(cronExpressionPattern: string): void;
     private get __hostName();
     static ɵfac: i0.ɵɵFactoryDeclaration<AXCronJobContainerComponent, never>;
@@ -234,7 +234,7 @@ declare class AXCronJobContainerComponent extends MXInputBaseValueComponent<stri
 
 declare class AXCronDayComponent {
     #private;
-    dayService: DayService;
+    protected dayService: DayService;
     protected boWeekDropDownList: DropDownItem[];
     protected boMonthDropDownList: DropDownItem[];
     protected daysIndexInMonth: number[];
@@ -255,7 +255,7 @@ declare class AXCronDayComponent {
 
 declare class AXCronHoursComponent {
     #private;
-    hoursService: HoursService;
+    protected hoursService: HoursService;
     protected dropdownList: DropDownItem[];
     protected zeroTo23: number[];
     hoursChanged: i0.OutputEmitterRef<void>;
@@ -309,7 +309,7 @@ declare class AXCronSecondsComponent {
 
 declare class AXCronYearComponent {
     #private;
-    yearService: YearService;
+    protected yearService: YearService;
     protected dropdownList: DropDownItem[];
     protected oneTo100: DropDownItem[];
     yearChanged: i0.OutputEmitterRef<void>;

package/data-pager/index.d.ts

@@ -377,28 +377,33 @@ declare class AXDataPagerComponent extends MXValueComponent<number> {
     private _emitChangedEvent;
     /**
      * Navigates to the next page, or to the last page if on the final page.
-     * @ignore
+     *
+     * @returns void - No return value. The component navigates to the next available page.
      */
     goNextPage(): void;
     /**
      * Navigates to the last page.
-     * @ignore
+     *
+     * @returns void - No return value. The component navigates to the final page.
      */
     goLastPage(): void;
     /**
      * Navigates to the first page.
-     * @ignore
+     *
+     * @returns void - No return value. The component navigates to the first page.
      */
     goFirstPage(): void;
     /**
      * Navigates to the previous page, or to the first page if on the initial page.
-     * @ignore
+     *
+     * @returns void - No return value. The component navigates to the previous available page.
      */
     goPrevPage(): void;
     /**
      * Navigates to a specified page.
+     *
      * @param page - The page number to navigate to.
-     * @ignore
+     * @returns void - No return value. The component navigates to the specified page.
      */
     goToPage(page: number): void;
     get __hostClass(): string;

package/datetime-picker/index.d.ts

@@ -30,6 +30,12 @@ declare class AXDateTimePickerComponent extends AXDateTimePickerComponent_base i
     private formatService;
     protected buttonText: _angular_core.Signal<"dateTime.today" | "dateTime.now">;
     private defaultConfig;
+    protected pickerHoursMinValue: _angular_core.WritableSignal<number>;
+    protected pickerHoursMaxValue: _angular_core.WritableSignal<number>;
+    protected pickerMinuteMinValue: _angular_core.WritableSignal<number>;
+    protected pickerMinuteMaxValue: _angular_core.WritableSignal<number>;
+    protected pickerSecondMinValue: _angular_core.WritableSignal<number>;
+    protected pickerSecondMaxValue: _angular_core.WritableSignal<number>;
     /**
      *  @ignore
      */
@@ -104,6 +110,8 @@ declare class AXDateTimePickerComponent extends AXDateTimePickerComponent_base i
      *  @ignore
      */
     protected _handleCalendarOnValueChanged(e: AXValueChangedEvent<Date>): void;
+    private checkSelectedMinValue;
+    private checkSelectedMaxValue;
     /**
      *  @ignore
      */

package/dropdown/index.d.ts

@@ -106,14 +106,55 @@ declare class AXDropdownBoxComponent extends AXDropdownBoxComponent_base impleme
 }
 
 declare abstract class MXDropdownBoxBaseComponent extends MXInteractiveComponent {
+    /**
+     * Emitted when the dropdown/popup is opened.
+     *
+     * @event
+     */
     onOpened: EventEmitter<AXEvent>;
+    /**
+     * Emits the `onOpened` event with component context.
+     * @ignore
+     */
     protected emitOnOpenedEvent(): void;
+    /**
+     * Emitted when the dropdown/popup is closed.
+     *
+     * @event
+     */
     onClosed: EventEmitter<AXEvent>;
+    /**
+     * Emits the `onClosed` event with component context.
+     * @ignore
+     */
     protected emitOnClosedEvent(): void;
+    /**
+     * Reference to the underlying dropdown controller.
+     */
     protected abstract dropdown: AXDropdownBoxComponent;
+    /**
+     * Toggles the dropdown if the component is not disabled.
+     *
+     * @returns void - No return value. Switches between open and closed states.
+     */
     toggle(): void;
+    /**
+     * Closes the dropdown if it is open and the component is not disabled, then focuses the host.
+     *
+     * @returns void - No return value. Dropdown is closed and focus returns to the host.
+     */
     close(): void;
+    /**
+     * Opens the dropdown if it is not already open and the component is not disabled, then focuses the dropdown.
+     *
+     * @returns void - No return value. Dropdown becomes open and receives focus.
+     */
     open(): void;
+    /**
+     * Indicates whether the dropdown is currently open.
+     *
+     * @returns boolean - True if open; otherwise false.
+     */
     get isOpen(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<MXDropdownBoxBaseComponent, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MXDropdownBoxBaseComponent>;

package/fesm2022/acorex-components-action-sheet.mjs

@@ -18,6 +18,33 @@ class AXActionSheetService {
         this.actionSheetEvent = new Subject();
         this.actionSheetEvent$ = this.actionSheetEvent.asObservable();
     }
+    /**
+     * Opens an action sheet with the specified configuration.
+     * This method creates and displays an action sheet component with the provided options.
+     * The action sheet will slide up from the bottom of the screen and can be dismissed
+     * by tapping outside, pressing escape, or calling the close method.
+     *
+     * @param config - The configuration object that defines the action sheet's appearance and behavior.
+     *                 Must include at least a title or content property. Will be merged with default config.
+     * @param isUserInteraction - Whether the action sheet is opened by user interaction (default: true).
+     *                           This affects how the action sheet handles accessibility and focus management.
+     * @returns A promise that resolves to a dialog reference containing methods to control the action sheet.
+     *          The reference includes methods like close() and a closed observable for tracking dialog state.
+     * @example
+     * ```typescript
+     * const dialogRef = await actionSheetService.open({
+     *   title: 'Choose an option',
+     *   items: [
+     *     { text: 'Option 1', value: 'opt1' },
+     *     { text: 'Option 2', value: 'opt2' }
+     *   ]
+     * });
+     *
+     * dialogRef.closed.subscribe(result => {
+     *   console.log('Action sheet closed with:', result.data);
+     * });
+     * ```
+     */
     open(config, isUserInteraction = true) {
         const defaultConfig = {
             title: 'action-sheet.title',
@@ -74,6 +101,16 @@ class AXActionSheetService {
         });
         return promise;
     }
+    /**
+     * Sets the current state of action sheet events.
+     * This method is used internally to track action sheet lifecycle events such as open, close,
+     * drag start, drag end, and full screen transitions. It emits events through the actionSheetEvent$
+     * observable for external subscribers to monitor action sheet state changes.
+     *
+     * @param event - The action sheet event to emit. Contains information about the event type,
+     *               associated data, user interaction status, and dialog reference.
+     * @returns void
+     */
     setActionSheetEventState(event) {
         this.actionSheetEvent.next(event);
     }
@@ -266,11 +303,30 @@ class AXActionSheetComponent extends MXBaseComponent {
             }
         }
     }
+    /**
+     * Handles click events on action sheet items.
+     * This method is called when a user clicks on an action sheet item. It closes the action sheet
+     * with the clicked item as the result data and executes the item's onClick callback if provided.
+     *
+     * @param item - The action sheet item that was clicked. Contains the item's data and optional onClick callback.
+     * @returns void
+     */
     onItemClick(item) {
         this.close(item);
         if (item?.onClick)
             item.onClick();
     }
+    /**
+     * Closes the action sheet with optional result data.
+     * This method initiates the closing animation of the action sheet and eventually closes the dialog.
+     * The closing process includes a height animation and cleanup of event listeners.
+     *
+     * @param e - The result data to pass when closing the action sheet. Can be any value including null.
+     *            If an AXActionSheetItem is passed, it represents the selected item.
+     * @param isUserInteraction - Whether the close action was triggered by user interaction (default: true).
+     *                           This affects how the action sheet handles accessibility and event tracking.
+     * @returns void
+     */
     close(e = null, isUserInteraction = true) {
         this.getHostElement().style.height = `${this.getHostElement().clientHeight}px`;
         setTimeout(() => {