@ionic/core 8.8.19-dev.11786610762.137bbb21 → 8.8.19-nightly.20260814

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

@@ -1,218 +0,0 @@
-import type { ComponentInterface } from '../../stencil-public-runtime';
-import type { GalleryColumns, GalleryGap } from './gallery-interface';
-/**
- * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
- * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
- *
- * @slot - One or more `ion-gallery-item` components, placed in a responsive
- * gallery layout.
- */
-export declare class Gallery implements ComponentInterface {
-    el: HTMLIonGalleryElement;
-    private masonryRaf?;
-    private resizeObserver?;
-    private lastWidth?;
-    private hasWarnedInvalidColumns;
-    private hasWarnedInvalidGap;
-    private hasWarnedUnusedOrder;
-    private hasWarnedInvalidItems;
-    /**
-     * The visual layout of the gallery. When `uniform`, rows take up the height
-     * of the tallest item and are spaced evenly across the gallery. Additionally,
-     * items will have an aspect ratio of 1/1, forcing them to be square unless a
-     * height is explicitly set. When `masonry`, items will be positioned under each
-     * other with only the specified gap between them.
-     */
-    layout: 'uniform' | 'masonry';
-    /**
-     * The order in which items are positioned. Only applies when layout is
-     * `masonry`. When `sequential`, items are positioned in the order they are
-     * placed in the DOM. When `best-fit`, items are positioned under the column
-     * with the most available space. Defaults to `sequential` when layout is
-     * `masonry` and `order` is not explicitly set.
-     */
-    order?: 'sequential' | 'best-fit';
-    /**
-     * The number of columns to display. Can be set as a number or an object of
-     * breakpoint values (e.g. `{ xs: 2, sm: 3, md: 4 }`).
-     */
-    columns: GalleryColumns;
-    /**
-     * The space between gallery items. Accepts valid CSS [length-percentage](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/length-percentage)
-     * values like `16px`, `1rem`, `20%`, math functions like `calc(10px + 20%)`,
-     * CSS variables like `var(--app-gallery-gap)`, or numbers (treated as pixel
-     * values). Can also be set as a breakpoint map
-     * (e.g. `{ xs: '8px', sm: '1rem', md: '24px' }`). Does not accept
-     * space-separated values or CSS keyword values like `inherit`, `auto`, etc.
-     */
-    gap: GalleryGap;
-    protected onColumnsOrGapChanged(): void;
-    protected onLayoutOrOrderChanged(): void;
-    /**
-     * Sync the current layout with each item when the gallery's `layout`
-     * changes.
-     */
-    private syncItemLayout;
-    componentDidLoad(): void;
-    disconnectedCallback(): void;
-    /**
-     * Observe the host and each item for size changes. Items are observed in
-     * addition to the host so masonry placement is recomputed when an item's
-     * rendered height changes — most importantly when a dynamically added
-     * `ion-gallery-item` finishes hydrating, which (unlike an `<img>`) emits no
-     * `load` event and does not change the host's measured size while collapsed.
-     */
-    private observeResizes;
-    /**
-     * Listen for the load event on child elements.
-     * When the layout is `masonry`, this listener is used to schedule a resize
-     * of the masonry grid when the child elements load. This is useful for when
-     * images take time to load.
-     */
-    protected onChildLoad(ev: Event): void;
-    /**
-     * Listen for the slotchange event on the slot. When the gallery's items are
-     * added or removed, re-collapse wrappers, re-observe items for size changes,
-     * and recompute the masonry grid.
-     */
-    private onSlotChange;
-    /**
-     * Recompute the gallery column and gap variables and masonry placement when
-     * columns, gap, layout, or order change.
-     */
-    private syncResponsiveLayout;
-    /**
-     * Batch masonry measurements to a single animation frame.
-     * This avoids repeated sync layouts during rapid resize/load/slot changes.
-     */
-    private scheduleMasonryResize;
-    /**
-     * Normalize a single column value (`columns` as a number, string, or one entry from
-     * a `columns` breakpoint map) to a positive integer. Returns `undefined` when
-     * the input cannot be interpreted as a finite number.
-     */
-    private sanitizeColumns;
-    /**
-     * Normalize a single gap value (`gap` as a number, a string such as a CSS
-     * length-percentage or `var()` reference, or one entry from a `gap`
-     * breakpoint map) to a CSS length string. Returns `undefined` when the
-     * input cannot be interpreted as a valid CSS length or `var()` reference.
-     */
-    private sanitizeGap;
-    /**
-     * Check if the value is a breakpoint map object.
-     */
-    private isBreakpointMap;
-    /**
-     * Check if the breakpoint map has any invalid values for the provided
-     * sanitizer. A breakpoint map is invalid when there are no valid breakpoint
-     * keys set (e.g. `{}` or `{ colums: 3 }`), or when a value under a
-     * breakpoint key fails the sanitizer (e.g. `{ xs: -3 }`, `{ sm: 'foo' }`).
-     */
-    private hasInvalidBreakpointMap;
-    /**
-     * Resolve a responsive value from a breakpoint map.
-     * Uses a breakpoint-specific default when custom values are missing/invalid.
-     */
-    private resolveFromBreakpoints;
-    /**
-     * Get the columns from a responsive breakpoint map.
-     * Returns the columns for the last matching breakpoint.
-     */
-    private getColumnsFromBreakpointMap;
-    /**
-     * Get the gap from a responsive breakpoint map.
-     * Returns the gap for the last matching breakpoint.
-     */
-    private getGapFromBreakpointMap;
-    /**
-     * Warn about an invalid columns value when it is set to a negative number,
-     * an empty breakpoint map, a map with no supported breakpoint keys,
-     * or a map with invalid breakpoint values.
-     */
-    private warnInvalidColumns;
-    /**
-     * Warn about an invalid gap value when it is set to a negative number,
-     * an empty breakpoint map, a map with no supported breakpoint keys,
-     * or a map with invalid breakpoint values.
-     */
-    private warnInvalidGap;
-    /**
-     * Warn when `order` is explicitly set while layout is `uniform`.
-     */
-    private warnUnusedOrder;
-    /**
-     * Resolve the active columns value for the current width. Falls back to
-     * the default responsive columns when the provided prop is invalid.
-     */
-    private getColumnsForWidth;
-    /**
-     * Resolve the active gap value for the current width.
-     */
-    private getGapForWidth;
-    /**
-     * Update the responsive styles for the gallery. This is used to update
-     * the columns and gap when the component width changes.
-     */
-    private updateResponsiveStyles;
-    /**
-     * Return the `ion-gallery-item` elements to place in the grid. Each item is a
-     * direct grid cell, whether a direct child or nested inside a pass-through
-     * wrapper (e.g. a layout `<div>`). Items belonging to a nested `ion-gallery`
-     * are excluded.
-     */
-    private getItems;
-    /**
-     * Collapse each pass-through wrapper's box with `display: contents` so its
-     * items participate in the gallery grid. Restore the box of a wrapper that
-     * no longer contains items, and warn about children that contain none.
-     */
-    private collapseWrappers;
-    /**
-     * Warn when the gallery has content that is not wrapped in an
-     * `ion-gallery-item` component. Items belonging to a nested
-     * gallery are considered invalid content for the parent gallery.
-     */
-    private warnInvalidItems;
-    /**
-     * Clear the item styles for the given item element.
-     * This is used to switch between uniform and masonry layouts.
-     */
-    private clearItemStyles;
-    /**
-     * Clear placement styles for all items when leaving masonry mode.
-     */
-    private clearMasonryStyles;
-    /**
-     * Whether the item contains any images that have not finished loading.
-     * Used to defer masonry placement until the rendered height is final.
-     */
-    private hasUnloadedImages;
-    /**
-     * Convert a rendered item height to the number of grid rows it should span.
-     * Returns undefined when the item has images that are not fully loaded yet.
-     */
-    private calculateRowSpan;
-    /**
-     * Get the index of the column to position the item in.
-     * When the order is `best-fit`, the column with the shortest height is
-     * returned. Otherwise, items are placed in the column that matches their
-     * natural DOM order.
-     */
-    private getColumnIndex;
-    /**
-     * Apply masonry placement by assigning each item a column and row span.
-     */
-    private layoutMasonry;
-    /**
-     * Measure the host and children, then compute masonry placement.
-     */
-    private resizeMasonryGrid;
-    /**
-     * Resolved order for layout and CSS. Order should be `undefined` for
-     * the uniform layout. When order is not set, it should be `"sequential"`
-     * for the masonry layout.
-     */
-    private getOrder;
-    render(): any;
-}

package/dist/types/components/gallery/test/utils.d.ts

@@ -1,3 +0,0 @@
-export declare const sharedGalleryStyles = "\n  ion-gallery {\n    width: 343px;\n  }\n";
-export declare const sharedGalleryItemStyles = "\n  ion-gallery-item {\n    color: #fff;\n  }\n\n  ion-gallery-item:nth-child(1) {\n    background: #ff6b6b;\n  }\n\n  ion-gallery-item:nth-child(2) {\n    background: #4ecdc4;\n  }\n\n  ion-gallery-item:nth-child(3) {\n    background: #ffe66d;\n    color: #333;\n  }\n\n  ion-gallery-item:nth-child(4) {\n    background: #5f27cd;\n  }\n\n  ion-gallery-item:nth-child(5) {\n    background: #7f8c8d;\n  }\n\n  ion-gallery-item:nth-child(6) {\n    background: #ff9f43;\n  }\n\n  ion-gallery-item:nth-child(7) {\n    background: #ff3f34;\n  }\n\n  ion-gallery-item:nth-child(8) {\n    background: #2ecc71;\n  }\n\n  ion-gallery-item:nth-child(9) {\n    background: #34495e;\n  }\n\n  ion-gallery-item:nth-child(10) {\n    background: #1abc9c;\n  }\n\n  ion-gallery-item:nth-child(11) {\n    background: #e67e22;\n  }\n\n  ion-gallery-item:nth-child(12) {\n    background: #9b59b6;\n  }\n";
-export declare const numberToWords: (value: number) => string;

package/dist/types/components/gallery-item/gallery-item.d.ts

@@ -1,33 +0,0 @@
-import type { ComponentInterface } from '../../stencil-public-runtime';
-/**
- * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
- * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
- *
- * @slot - The content placed inside of the gallery item. This is typically an
- * `img`, but can be any element (e.g. a `figure` wrapping an image and caption).
- */
-export declare class GalleryItem implements ComponentInterface {
-    private hasWarnedInvalidParent;
-    el: HTMLIonGalleryItemElement;
-    /**
-     * The layout of the parent `ion-gallery`, mirrored as a class so the item
-     * can apply layout-specific styles (e.g. a square aspect ratio in the
-     * `uniform` layout, a bottom margin in the `masonry` layout).
-     */
-    galleryLayout?: 'uniform' | 'masonry';
-    componentWillLoad(): void;
-    componentDidLoad(): void;
-    connectedCallback(): void;
-    /**
-     * Resolve the layout from the parent `ion-gallery`. Called internally on
-     * load and connect, and by the gallery when its layout changes.
-     * @internal
-     */
-    syncGalleryLayout(): Promise<void>;
-    private onSlotChange;
-    /**
-     * Warn when the item is not a descendant of an `ion-gallery`.
-     */
-    private warnInvalidParent;
-    render(): any;
-}

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

@@ -1 +0,0 @@
-export type HeaderScrollEffect = 'hide' | 'condense' | 'fade';

package/dist/types/components/modal/animations/ionic.enter.d.ts

@@ -1,6 +0,0 @@
-import type { Animation } from '../../../interface';
-import type { ModalAnimationOptions } from '../modal-interface';
-/**
- * Ionic Modal Enter Animation
- */
-export declare const ionicEnterAnimation: (baseEl: HTMLElement, opts: ModalAnimationOptions) => Animation;

package/dist/types/components/modal/animations/ionic.leave.d.ts

@@ -1,6 +0,0 @@
-import type { Animation } from '../../../interface';
-import type { ModalAnimationOptions } from '../modal-interface';
-/**
- * Md Modal Leave Animation
- */
-export declare const ionicLeaveAnimation: (baseEl: HTMLElement, opts: ModalAnimationOptions) => Animation;

package/dist/types/utils/css-value-validation.d.ts

@@ -1,21 +0,0 @@
-/**
- * Helpers for validating user-supplied CSS values using regular expressions, without
- * relying on browser CSS APIs.
- */
-/**
- * Returns whether `value` matches the [length-percentage](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/length-percentage)
- * syntax. Accepts `<length>` (`<number>` + unit identifier) or `<percentage>` (`<number>%`).
- * Also supports simple `calc` / `min` / `max` / `clamp(...)` functions.
- *
- * @param value String value to validate.
- */
-export declare function isValidLengthPercentage(value: string): boolean;
-/**
- * Returns whether `value` is a single [`var()`](https://developer.mozilla.org/en-US/docs/Web/CSS/var)
- * reference, e.g. `var(--my-token)` or `var(--my-token, 16px)`. The referenced
- * custom property is resolved by the browser, so the resolved value is not
- * validated here.
- *
- * @param value String value to validate.
- */
-export declare function isCssVariable(value: string): boolean;

package/dist/types/utils/forms/clear-button-press-controller.d.ts

@@ -1,20 +0,0 @@
-/**
- * Tracks an in-flight press on a clear button so a blur landing mid-press can't
- * hide or unmount the button before the press produces its click.
- *
- * Calling `preventDefault()` on `pointerdown` is meant to stop the field
- * blurring, but not every browser honors it (iOS Safari blurs anyway). The
- * press is released on `click` rather than `pointerup` because touch
- * dispatches the click after the finger lifts.
- *
- * @internal
- * @param onPressChange Receives the press state.
- */
-export declare const createClearButtonPressController: (onPressChange: (isPressed: boolean) => void) => ClearButtonPressController;
-export type ClearButtonPressController = {
-    onPointerDown: (ev: PointerEvent) => void;
-    /** Ends the press without waiting for a click. */
-    release: () => void;
-    /** Ends any in-flight press. The controller stays usable if the host reconnects. */
-    destroy: () => void;
-};

package/dist/types/utils/overlay-control-label.d.ts

@@ -1,34 +0,0 @@
-import type { Theme } from '../interface';
-/**
- * Returns the default `labelPlacement` for a radio or checkbox option
- * rendered inside an overlay. Defaults follow each theme's established
- * option-row layout:
- * - `ionic`: always `"start"`.
- * - `ios`: `"start"` for radio in `alert` and `popover`. The `modal`
- *   interface flips iOS radio back to `"end"`. Checkbox is always
- *   `"end"` on iOS.
- * - everything else (e.g. `md`): `"end"`.
- *
- * `interfaceType` is optional; only `"modal"` changes the result, so
- * callers that aren't a modal can omit it.
- *
- * Used by `alert`, `select-popover`, and `select-modal` as the fallback
- * when an option doesn't explicitly set `labelPlacement`.
- */
-export declare const getOverlayLabelPlacement: (theme: Theme, control: "radio" | "checkbox", interfaceType?: "alert" | "popover" | "modal") => "start" | "end";
-/**
- * Returns the default `justify` for a radio or checkbox option rendered
- * inside an overlay. Defaults follow each theme's option-row layout:
- * - `ionic`: always `"space-between"`.
- * - `ios`: `"space-between"` for radio in `alert` and `popover`. The
- *   `modal` interface falls back to `"start"`. Checkbox is always `"start"`
- *   on iOS.
- * - everything else (e.g. `md`): `"start"`.
- *
- * `interfaceType` is optional; only `"modal"` changes the result, so
- * callers that aren't a modal can omit it.
- *
- * Used by `alert`, `select-popover`, and `select-modal` as the fallback when
- * an option doesn't explicitly set `justify`.
- */
-export declare const getOverlayLabelJustify: (theme: Theme, control: "radio" | "checkbox", interfaceType?: "alert" | "popover" | "modal") => "start" | "end" | "space-between";

package/dist/types/utils/scroll-hide-controller.d.ts

@@ -1,56 +0,0 @@
-export interface ScrollHideOptions {
-    /** The component's host element. */
-    el: HTMLElement;
-    /** CSS variable name for the hide height, e.g. `--internal-header-hide-height`. */
-    cssVar: string;
-    /** Class toggled on the component when hidden, e.g. `header-scroll-hidden`. */
-    hiddenClass: string;
-    /** Class added to content when the scroll-hide effect is active, e.g. `content-header-hide-scroll-partner`. */
-    contentPartnerClass: string;
-    /** Class toggled on content when hidden, e.g. `content-header-hide-scroll-hidden`. */
-    contentHiddenClass: string;
-    /**
-     * Optional guard called before removing aria-hidden on show.
-     * Return `true` to keep aria-hidden (e.g. when the keyboard is open).
-     */
-    shouldKeepAriaHidden?: () => boolean;
-}
-export type ScrollHideController = {
-    /** Whether the component is currently hidden by the scroll effect. */
-    isHidden: () => boolean;
-    /**
-     * Activate the controller by attaching listeners, observers, and
-     * content classes. Must be called only after the caller confirms this
-     * setup is still current (promise-identity guard). A controller that
-     * is never initialized has no side effects and can be discarded.
-     */
-    init: () => void;
-    /** Destroy all listeners, observers, and clean up DOM state. */
-    destroy: () => void;
-};
-/**
- * Creates a controller that manages scroll-based hide/show behavior
- * for headers, footers, and tab bars.
- *
- * Listens to both wheel and scroll events. Wheel events (desktop mice)
- * give direction instantly via deltaY. Scroll events cover touch,
- * trackpad, and programmatic scrolling where wheel doesn't fire.
- * A short suppression window stops them from double-processing the
- * same gesture.
- *
- * When the user reverses scroll direction, we save that position as
- * an anchor. The bar only hides after scrolling 60px past that
- * anchor, which prevents flickering on small or jittery movements.
- * Showing is immediate on direction change.
- *
- * When `options` is provided, the controller also handles the DOM
- * setup: ResizeObserver for height tracking, CSS variable read/write,
- * content partner/hidden class toggling, inert/aria-hidden, and
- * full teardown cleanup. This avoids duplicating the same setup
- * across header, footer, and tab-bar.
- *
- * @internal
- * @param contentEl The content element to resolve the scroll element from.
- * @param options Configuration for DOM setup (classes, CSS vars, a11y).
- */
-export declare const createScrollHideController: (contentEl: HTMLElement, options: ScrollHideOptions) => Promise<ScrollHideController>;

package/dist/types/utils/select-option-render.d.ts

@@ -1,53 +0,0 @@
-import type { VNode } from '../stencil-public-runtime';
-import type { RichContentOption as RichContentOpt } from '../components/select/select-interface';
-interface RichContentOption extends RichContentOpt {
-    /** Unique identifier for stable virtual DOM keys across re-renders. */
-    id: string;
-    /** The main label for the option as a string or an HTMLElement. */
-    label?: string | HTMLElement;
-}
-/**
- * Converts a DOM node into a Stencil VNode (or text string) so the
- * resulting tree is rendered through the component's normal render
- * path. Rendering through Stencil ensures that scoped CSS classes
- * (e.g. `sc-ion-action-sheet-ionic`) are applied to every element.
- *
- * Highly recommended to pre-sanitize the source DOM (see
- * `getOptionContent` in select.tsx). This function performs pure
- * structural conversion — no security filtering.
- *
- * Preserves attributes only — properties set imperatively on the source
- * element (e.g. `input.value` after a user types) won't carry through.
- * In practice this isn't a concern: interactive controls shouldn't
- * appear in select-option rich content since they'd nest inside the
- * overlay's button/radio/checkbox wrapper, which is invalid HTML and
- * an accessibility issue.
- *
- * @param node - The DOM node to convert. Text nodes become strings,
- * element nodes become VNodes, and any other node types are skipped.
- * @param keyPrefix - String prefix used to build a stable VNode key,
- * so Stencil's diff can preserve elements across re-renders.
- * @param index - Position of this node among its siblings. Combined
- * with `keyPrefix` to form the final unique key.
- * @returns The converted VNode, a text string, or `null` if the node
- * type isn't supported.
- *
- * @internal Exported only so it can be unit tested; not part of the
- * public API.
- */
-export declare const cloneToVNode: (node: Node, keyPrefix: string, index: number) => VNode | string | null;
-/**
- * Renders the label content for a select option within an overlay
- * interface based on the presence of rich content.
- *
- * Span elements should be used when this content renders within buttons,
- * depending on the select interface. Buttons can only have phrasing
- * content to prevent accessibility issues.
- *
- * @param option - The content option data containing label, slots,
- * and description.
- * @param className - The base CSS class for the label element.
- * @param useSpan - Whether to use a span element instead of a div for the label.
- */
-export declare const renderOptionLabel: (option: RichContentOption, className: string, useSpan?: boolean) => HTMLElement | string | undefined;
-export {};