@ionic/core 8.8.14-dev.11784216165.1ecbf364 → 8.8.14-dev.11784238294.131cd99d

package/dist/types/components/picker-legacy/picker.d.ts

@@ -0,0 +1,158 @@
+import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
+import type { AnimationBuilder, OverlayInterface, FrameworkDelegate } from '../../interface';
+import type { OverlayEventDetail } from '../../utils/overlays-interface';
+import type { PickerButton, PickerColumn } from './picker-interface';
+/**
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
+ */
+export declare class Picker implements ComponentInterface, OverlayInterface {
+    private readonly delegateController;
+    private readonly lockController;
+    private readonly triggerController;
+    private durationTimeout?;
+    lastFocus?: HTMLElement;
+    el: HTMLIonPickerLegacyElement;
+    presented: boolean;
+    /** @internal */
+    overlayIndex: number;
+    /** @internal */
+    delegate?: FrameworkDelegate;
+    /** @internal */
+    hasController: boolean;
+    /**
+     * If `true`, the keyboard will be automatically dismissed when the overlay is presented.
+     */
+    keyboardClose: boolean;
+    /**
+     * Animation to use when the picker is presented.
+     */
+    enterAnimation?: AnimationBuilder;
+    /**
+     * Animation to use when the picker is dismissed.
+     */
+    leaveAnimation?: AnimationBuilder;
+    /**
+     * Array of buttons to be displayed at the top of the picker.
+     */
+    buttons: PickerButton[];
+    /**
+     * Array of columns to be displayed in the picker.
+     */
+    columns: PickerColumn[];
+    /**
+     * Additional classes to apply for custom CSS. If multiple classes are
+     * provided they should be separated by spaces.
+     */
+    cssClass?: string | string[];
+    /**
+     * Number of milliseconds to wait before dismissing the picker.
+     */
+    duration: number;
+    /**
+     * If `true`, a backdrop will be displayed behind the picker.
+     */
+    showBackdrop: boolean;
+    /**
+     * If `true`, the picker will be dismissed when the backdrop is clicked.
+     */
+    backdropDismiss: boolean;
+    /**
+     * If `true`, the picker will animate.
+     */
+    animated: boolean;
+    /**
+     * Additional attributes to pass to the picker.
+     */
+    htmlAttributes?: {
+        [key: string]: any;
+    };
+    /**
+     * If `true`, the picker will open. If `false`, the picker will close.
+     * Use this if you need finer grained control over presentation, otherwise
+     * just use the pickerController or the `trigger` property.
+     * Note: `isOpen` will not automatically be set back to `false` when
+     * the picker dismisses. You will need to do that in your code.
+     */
+    isOpen: boolean;
+    onIsOpenChange(newValue: boolean, oldValue: boolean): void;
+    /**
+     * An ID corresponding to the trigger element that
+     * causes the picker to open when clicked.
+     */
+    trigger: string | undefined;
+    triggerChanged(): void;
+    /**
+     * Emitted after the picker has presented.
+     */
+    didPresent: EventEmitter<void>;
+    /**
+     * Emitted before the picker has presented.
+     */
+    willPresent: EventEmitter<void>;
+    /**
+     * Emitted before the picker has dismissed.
+     */
+    willDismiss: EventEmitter<OverlayEventDetail>;
+    /**
+     * Emitted after the picker has dismissed.
+     */
+    didDismiss: EventEmitter<OverlayEventDetail>;
+    /**
+     * Emitted after the picker has presented.
+     * Shorthand for ionPickerWillDismiss.
+     */
+    didPresentShorthand: EventEmitter<void>;
+    /**
+     * Emitted before the picker has presented.
+     * Shorthand for ionPickerWillPresent.
+     */
+    willPresentShorthand: EventEmitter<void>;
+    /**
+     * Emitted before the picker has dismissed.
+     * Shorthand for ionPickerWillDismiss.
+     */
+    willDismissShorthand: EventEmitter<OverlayEventDetail>;
+    /**
+     * Emitted after the picker has dismissed.
+     * Shorthand for ionPickerDidDismiss.
+     */
+    didDismissShorthand: EventEmitter<OverlayEventDetail>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    /**
+     * Present the picker overlay after it has been created.
+     */
+    present(): Promise<void>;
+    /**
+     * Dismiss the picker overlay after it has been presented.
+     *
+     * @param data Any data to emit in the dismiss events.
+     * @param role The role of the element that is dismissing the picker.
+     * This can be useful in a button handler for determining which button was
+     * clicked to dismiss the picker.
+     * Some examples include: ``"cancel"`, `"destructive"`, "selected"`, and `"backdrop"`.
+     */
+    dismiss(data?: any, role?: string): Promise<boolean>;
+    /**
+     * Returns a promise that resolves when the picker did dismiss.
+     */
+    onDidDismiss<T = any>(): Promise<OverlayEventDetail<T>>;
+    /**
+     * Returns a promise that resolves when the picker will dismiss.
+     */
+    onWillDismiss<T = any>(): Promise<OverlayEventDetail<T>>;
+    /**
+     * Get the column that matches the specified name.
+     *
+     * @param name The name of the column.
+     */
+    getColumn(name: string): Promise<PickerColumn | undefined>;
+    private buttonClick;
+    private callButtonHandler;
+    private getSelected;
+    private onBackdropTap;
+    private dispatchCancelHandler;
+    render(): any;
+}

package/dist/types/components/picker-legacy-column/picker-column.d.ts

@@ -0,0 +1,46 @@
+import type { ComponentInterface, EventEmitter } from '../../stencil-public-runtime';
+import type { PickerColumn } from '../picker-legacy/picker-interface';
+/**
+ * @internal
+ */
+export declare class PickerColumnCmp implements ComponentInterface {
+    private bounceFrom;
+    private lastIndex?;
+    private minY;
+    private maxY;
+    private optHeight;
+    private rotateFactor;
+    private scaleFactor;
+    private velocity;
+    private y;
+    private optsEl?;
+    private gesture?;
+    private rafId?;
+    private tmrId?;
+    private noAnimate;
+    private colDidChange;
+    el: HTMLElement;
+    /**
+     * Emitted when the selected value has changed
+     * @internal
+     */
+    ionPickerColChange: EventEmitter<PickerColumn>;
+    /** Picker column data */
+    col: PickerColumn;
+    protected colChanged(): void;
+    connectedCallback(): Promise<void>;
+    componentDidLoad(): void;
+    componentDidUpdate(): void;
+    disconnectedCallback(): void;
+    private emitColChange;
+    private setSelected;
+    private update;
+    private decelerate;
+    private indexForY;
+    private onStart;
+    private onMove;
+    private onEnd;
+    private refresh;
+    private onDomChange;
+    render(): any;
+}

package/dist/types/components/picker-legacy-column/test/test.utils.d.ts

@@ -0,0 +1,9 @@
+import type { E2EPage, ScreenshotFn } from "../../../utils/test/playwright/index";
+/**
+ * Visual regression tests for picker-column.
+ * @param page - The page to run the tests on.
+ * @param screenshot - The screenshot function to generate unique screenshot names
+ * @param buttonSelector - The selector for the button that opens the picker.
+ * @param description - The description to amend to the screenshot names (typically 'single' or 'multiple').
+ */
+export declare function testPickerColumn(page: E2EPage, screenshot: ScreenshotFn, buttonSelector: string, description: string): Promise<void>;

package/dist/types/components/route/route.d.ts

@@ -9,7 +9,7 @@ export declare class Route implements ComponentInterface {
      */
     url: string;
     /**
-     * Name of the component to load/select in the navigation outlet (`ion-tabs`, `ion-router-outlet`)
+     * Name of the component to load/select in the navigation outlet (`ion-tabs`, `ion-nav`)
      * when the route matches.
      *
      * The value of this property is not always the tagname of the component to load,

package/dist/types/components/router-outlet/router-outlet.d.ts

@@ -23,12 +23,6 @@ export declare class RouterOutlet implements ComponentInterface, NavOutlet {
     animated: boolean;
     /** This property allows to create custom transition using AnimationBuilder functions. */
     animation?: AnimationBuilder;
-    /**
-     * If `true`, the router-outlet should allow navigation via swipe-to-go-back gesture.
-     * Defaults to `true` for `"ios"` mode and `false` for `"md"` mode.
-     */
-    swipeGesture?: boolean;
-    swipeGestureChanged(): void;
     /** @internal */
     swipeHandler?: SwipeGestureHandler;
     swipeHandlerChanged(): void;
@@ -40,7 +34,6 @@ export declare class RouterOutlet implements ComponentInterface, NavOutlet {
     ionNavDidChange: EventEmitter<void>;
     connectedCallback(): Promise<void>;
     componentWillLoad(): void;
-    private updateGestureEnabled;
     disconnectedCallback(): void;
     /** @internal */
     commit(enteringEl: HTMLElement, leavingEl: HTMLElement | undefined, opts?: RouterOutletOptions): Promise<boolean>;

package/dist/types/components/searchbar/searchbar.d.ts

@@ -52,7 +52,7 @@ export declare class Searchbar implements ComponentInterface {
     /**
      * Set the input's autocorrect property.
      */
-    autocorrect: boolean;
+    autocorrect: 'on' | 'off';
     /**
      * Set the cancel button icon. Only applies to `md` mode.
      * Defaults to `arrow-back-sharp`.

package/dist/types/components/select/select-interface.d.ts

@@ -1,6 +1,3 @@
-import type { ActionSheetButton } from '../action-sheet/action-sheet-interface';
-import type { AlertInput } from '../alert/alert-interface';
-import type { SelectPopoverOption } from '../select-popover/select-popover-interface';
 export type SelectInterface = 'action-sheet' | 'popover' | 'alert' | 'modal';
 export type SelectCompareFn = (currentValue: any, compareValue: any) => boolean;
 export interface SelectChangeEventDetail<T = any> {
@@ -10,31 +7,3 @@ export interface SelectCustomEvent<T = any> extends CustomEvent {
     detail: SelectChangeEventDetail<T>;
     target: HTMLIonSelectElement;
 }
-export interface SelectActionSheetButton extends Omit<ActionSheetButton, 'text'>, RichContentOption {
-    /** The main text for the option as a string or an HTMLElement. */
-    text?: string | HTMLElement;
-}
-export interface SelectAlertInput extends Omit<AlertInput, 'label'>, RichContentOption {
-    /** The main label for the option as a string or an HTMLElement. */
-    label?: string | HTMLElement;
-    /** Where the label sits relative to the option's selection control. */
-    labelPlacement?: 'start' | 'end';
-    /** How to pack the label and the option's selection control within a line. */
-    justify?: 'start' | 'end' | 'space-between';
-}
-export interface SelectOverlayOption extends Omit<SelectPopoverOption, 'text'>, RichContentOption {
-    /** The main text for the option as a string or an HTMLElement. */
-    text?: string | HTMLElement;
-    /** Where the label sits relative to the option's selection control. */
-    labelPlacement?: 'start' | 'end';
-    /** How to pack the label and the option's selection control within a line. */
-    justify?: 'start' | 'end' | 'space-between';
-}
-export interface RichContentOption {
-    /** Content to display at the start of the option. */
-    startContent?: HTMLElement;
-    /** Content to display at the end of the option. */
-    endContent?: HTMLElement;
-    /** A description for the option. */
-    description?: string;
-}

package/dist/types/components/select/select.d.ts

@@ -32,7 +32,6 @@ export declare class Select implements ComponentInterface {
     private notchSpacerEl;
     private validationObserver?;
     private notchController?;
-    private customHTMLEnabled;
     el: HTMLIonSelectElement;
     isExpanded: boolean;
     /**
@@ -204,7 +203,6 @@ export declare class Select implements ComponentInterface {
     ionStyle: EventEmitter<StyleEventDetail>;
     protected styleChanged(): void;
     private setValue;
-    private isValueEqual;
     connectedCallback(): Promise<void>;
     componentWillLoad(): void;
     componentDidLoad(): void;
@@ -240,12 +238,6 @@ export declare class Select implements ComponentInterface {
      * was passed.
      */
     private get labelText();
-    /**
-     * Returns the text to display in the select based on the selected value.
-     *
-     * @param useHTML If `true`, the returned text will include any custom HTML content from the selected option. If `false`, the returned text will be plain text without any HTML. Defaults to `false`.
-     * @returns The text to display in the select, either with or without HTML based on the `useHTML` parameter.
-     */
     private getText;
     private setFocus;
     private emitStyle;
@@ -276,16 +268,6 @@ export declare class Select implements ComponentInterface {
      * when fill="outline".
      */
     private renderLabelContainer;
-    /**
-     * Wraps text nodes in the select text with span elements
-     * so spacing can be added between elements without
-     * changing the display to prevent losing the ellipses
-     * behavior.
-     *
-     * Only wraps when the string contains HTML elements
-     * alongside text.
-     */
-    private wrapSelectTextNodes;
     /**
      * Renders either the placeholder
      * or the selected values based on

package/dist/types/components/select-option/select-option.d.ts

@@ -1,55 +1,14 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
-/**
- * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
- *
- * @slot - Content is placed between the named slots if provided without a slot.
- * @slot start - Content is placed to the left of the select option text in LTR, and to the right in RTL.
- * @slot end - Content is placed to the right of the select option text in LTR, and to the left in RTL.
- */
 export declare class SelectOption implements ComponentInterface {
     private inputId;
     el: HTMLElement;
     /**
-     * If `true`, the user cannot interact with the select option.
+     * If `true`, the user cannot interact with the select option. This property does not apply when `interface="action-sheet"` as `ion-action-sheet` does not allow for disabled buttons.
      */
     disabled: boolean;
     /**
      * The text value of the option.
      */
     value?: any | null;
-    /**
-     * Text that is placed underneath the option text to provide additional details about the option.
-     */
-    description?: string;
-    /**
-     * Where the label is placed relative to the option's selection control
-     * (radio circle or checkbox box) when the option is rendered in an
-     * `alert`, `popover`, or `modal` interface.
-     * `"start"`: The label will appear to the left of the radio in LTR and to the right in RTL.
-     * `"end"`: The label will appear to the right of the radio in LTR and to the left in RTL.
-     *
-     * Applies to the `alert`, `popover`, and `modal` interfaces, but has no
-     * visible effect on radio options in `popover` or `modal` on `md` (the radio control is hidden there).
-     *
-     * When unset, the interface picks a default based on mode and control
-     * type.
-     */
-    labelPlacement?: 'start' | 'end';
-    /**
-     * How to pack the label and the option's selection control within a line.
-     * `"start"`: The label and radio will appear on the left in LTR and
-     * on the right in RTL.
-     * `"end"`: The label and radio will appear on the right in LTR and
-     * on the left in RTL.
-     * `"space-between"`: The label and radio will appear on opposite
-     * ends of the line with space between the two elements.
-     *
-     * Applies to the `alert`, `popover`, and `modal` interfaces, but has no
-     * visible effect on radio options in `popover` or `modal` on `md` (the radio control is hidden there).
-     *
-     * When unset, the interface picks a default based on mode and control
-     * type.
-     */
-    justify?: 'start' | 'end' | 'space-between';
     render(): any;
 }