@aurodesignsystem-dev/auro-formkit 0.0.0-pr1497.5 → 0.0.0-pr1498.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurodesignsystem-dev/auro-formkit",
-  "version": "0.0.0-pr1497.5",
+  "version": "0.0.0-pr1498.0",
   "description": "A collection of web components used to build forms.",
   "homepage": "https://github.com/AlaskaAirlines/auro-formkit#readme",
   "bugs": {

package/components/menu/dist/auro-menu.context.d.ts

@@ -1,238 +0,0 @@
-export class MenuService {
-    /**
-     * CONSTRUCTOR
-     */
-    /**
-     * Creates a new MenuService instance.
-     * @param {Object} options - The options object.
-     *   @param {AuroMenu} options.host - The host element that this service will control. Required.
-     * @throws {Error} If the host is not provided.
-     */
-    constructor({ host }?: {
-        host: AuroMenu;
-    });
-    /**
-     * PROPERTIES AND GETTERS
-     */
-    /**
-     * Gets the list of registered menu options.
-     * @returns {AuroMenuOption[]}
-     */
-    get menuOptions(): AuroMenuOption[];
-    /**
-     * Gets the currently highlighted option.
-     * @returns {AuroMenuOption|null}
-     */
-    get highlightedOption(): AuroMenuOption | null;
-    /**
-     * Gets the current value(s) of the selected option(s).
-     * @returns {string|string[]|undefined}
-     */
-    get currentValue(): string | string[] | undefined;
-    /**
-     * Gets the label(s) of the currently selected option(s).
-     * @returns {string}
-     */
-    get currentLabel(): string;
-    /**
-     * Gets the string representation of the current value(s).
-     * For multi-select, this is a JSON stringified array.
-     * @returns {string|undefined}
-     */
-    get stringValue(): string | undefined;
-    /**
-     * Gets the key(s) of the currently selected option(s).
-     * @returns {string|string[]|undefined}
-     */
-    get currentKeys(): string | string[] | undefined;
-    host: any;
-    size: any;
-    shape: any;
-    noCheckmark: any;
-    disabled: any;
-    matchWord: any;
-    multiSelect: any;
-    allowDeselect: any;
-    selectAllMatchingOptions: any;
-    highlightedIndex: number;
-    _menuOptions: any[];
-    _subscribers: any[];
-    internalUpdateInProgress: boolean;
-    selectedOptions: any[];
-    _pendingValue: string | number | (string | number)[] | null;
-    _pendingRetryScheduled: boolean;
-    _pendingRetryCount: number;
-    /**
-     * PROPERTY SYNCING
-     */
-    /**
-     * Handles host updates.
-     * This is a lit reactive lifecycle method.
-     * This comes from the Lit controller interface provided by adding this service as a controller to the host.
-     * See constructor for `this.host.addController(this)`
-     * You can read more about Lit reactive controllers here: https://lit.dev/docs/composition/controllers/
-     */
-    hostUpdated(): void;
-    /**
-     * Handles host disconnection and memory cleanup.
-     */
-    hostDisconnected(): void;
-    /**
-     * Sets a property value if it exists on the instance and the value has changed.
-     * @param {string} property
-     * @param {any} value
-     */
-    setProperty(property: string, value: any): void;
-    /**
-     * Sets multiple properties on the instance.
-     * @param {Object} properties - Key-value pairs of properties to set.
-     */
-    setProperties(properties: Object): void;
-    /**
-     * MENU OPTION HIGHLIGHTING
-     */
-    /**
-     * Highlights the next active option in the menu.
-     */
-    highlightNext(): void;
-    /**
-     * Highlights the previous active option in the menu.
-     */
-    highlightPrevious(): void;
-    /**
-     * Moves the highlighted option in the specified direction.
-     * @param {string} direction - The direction to move the highlight ("next" or "previous").
-     */
-    moveHighlightedOption(direction: string): void;
-    /**
-     * Sets the highlighted index to the specified option.
-     * @param {AuroMenuOption} option - The option to highlight.
-     */
-    setHighlightedOption(option: AuroMenuOption): void;
-    /**
-     * Sets the highlighted option to the option at the specified index if it exists.
-     * @param {number} index
-     */
-    setHighlightedIndex(index: number): void;
-    /**
-     * Selects the currently highlighted option.
-     */
-    selectHighlightedOption(): void;
-    /**
-     * SELECTION AND DESELECTION METHODS
-     */
-    /**
-     * Selects one or more options in a batch operation
-     * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to select
-     */
-    selectOptions(options: AuroMenuOption | AuroMenuOption[]): void;
-    /**
-     * Deselects one or more options in a batch operation
-     * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to deselect
-     */
-    deselectOptions(options: AuroMenuOption | AuroMenuOption[]): void;
-    /**
-     * Selects a single option.
-     * @param {AuroMenuOption} option
-     */
-    selectOption(option: AuroMenuOption): void;
-    /**
-     * Deselects a single option.
-     * @param {AuroMenuOption} option
-     */
-    deselectOption(option: AuroMenuOption): void;
-    /**
-     * Toggles the selection state of a single option.
-     * @param {AuroMenuOption} option
-     */
-    toggleOption(option: AuroMenuOption): void;
-    /**
-     * Selects options based on their value(s) when compared to a passed value or values.
-     * Value or values are normalized to an array of strings that can be matched to option keys.
-     * @param {string|number|Array<string|number>} value - The value(s) to select.
-     */
-    selectByValue(value: string | number | Array<string | number>): void;
-    /**
-     * Queues a pending value and schedules a bounded retry.
-     * @param {string|number|Array<string|number>} value - The value to retry.
-     */
-    queuePendingValue(value: string | number | Array<string | number>): void;
-    /**
-     * Clears pending retry state.
-     */
-    clearPendingValue(): void;
-    /**
-     * Resets the selected options to an empty array.
-     */
-    reset(): void;
-    /**
-     * SUBSCRIPTION, NOTIFICATION AND EVENT DISPATCH METHODS
-     */
-    /**
-     * Subscribes a callback to menu service events.
-     * @param {Function} callback - The callback to invoke on events.
-     */
-    subscribe(callback: Function): void;
-    /**
-     * Remove a previously subscribed callback from menu service events.
-     * @param {Function} callback
-     */
-    unsubscribe(callback: Function): void;
-    /**
-     * Stages an update to notify subscribers of state and value changes.
-     */
-    stageUpdate(meta?: {}): void;
-    /**
-     * Notifies subscribers of a menu service event.
-     * All notifications are sent to all subscribers.
-     * @param {string} event - The event to send to subscribers.
-     */
-    notify(event: string): void;
-    /**
-     * Notifies subscribers of a state change (selected options has changed).
-     */
-    notifyStateChange(meta?: {}): void;
-    /**
-     * Notifies subscribers of a value change (current value has changed).
-     */
-    notifyValueChange(meta?: {}): void;
-    /**
-     * Dispatches a custom event from the host element.
-     * @param {string} eventName
-     * @param {any} detail
-     */
-    dispatchChangeEvent(eventName: string, detail: any): void;
-    /**
-     * MENU OPTION MANAGEMENT METHODS
-     */
-    /**
-     * Adds a menu option to the service's list.
-     * @param {AuroMenuOption} option - the option to track
-     */
-    addMenuOption(option: AuroMenuOption): void;
-    /**
-     * Removes a menu option from the service's list.
-     * @param {AuroMenuOption} option - the option to remove
-     */
-    removeMenuOption(option: AuroMenuOption): void;
-    /**
-     * UTILITIES
-     */
-    /**
-     * Normalizes a value or array of values into an array of strings for option selection.
-     * This function ensures that input values are consistently formatted for matching menu options.
-     *
-     * @param {string|number|Array<string|number>} value - The value(s) to normalize.
-     * @returns {Array<string>} An array of string values suitable for option matching.
-     * @throws {Error} If any value is not a string or number.
-     */
-    _getNormalizedValues(value: string | number | Array<string | number>): Array<string>;
-    /**
-     * Returns whether two arrays of options contain the same elements.
-     * @param {AuroMenuOption[]} arr1 - First array of options.
-     * @param {AuroMenuOption[]} arr2 - Second array of options.
-     * @returns {boolean} True if arrays match, false otherwise.
-     */
-    optionsArraysMatch(arr1: AuroMenuOption[], arr2: AuroMenuOption[]): boolean;
-}
-export const MenuContext: import("@lit/context").Context<"menu-context", any>;