uicore-ts 1.1.238 → 1.1.252

package/compiledScripts/UIAutocompleteTextField.d.ts

@@ -9,6 +9,8 @@ export declare class UIAutocompleteTextField<T = string> extends UITextField {
     _isDropdownOpen: boolean;
     _strictSelection: boolean;
     _isValid: boolean;
+    _userHasNavigatedDropdown: boolean;
+    _isProgrammaticTextChange: boolean;
     /**
      * When YES, the filter text is split on whitespace and all words must appear
      * in the item label (AND logic). When NO (default), the full filter string is

package/compiledScripts/UIAutocompleteTextField.js

@@ -32,6 +32,8 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
     this._isDropdownOpen = import_UIObject.NO;
     this._strictSelection = import_UIObject.NO;
     this._isValid = import_UIObject.YES;
+    this._userHasNavigatedDropdown = import_UIObject.NO;
+    this._isProgrammaticTextChange = import_UIObject.NO;
     this.usesMultiWordAndSearch = import_UIObject.NO;
     this._dropdownView = this.newDropdownView();
     this._dropdownView.didSelectItem = (item) => {
@@ -42,8 +44,11 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
     this.controlEventTargetAccumulator.Focus = () => {
       textBeforeFocus = this.text;
       itemBeforeFocus = this.selectedItem;
+      this._userHasNavigatedDropdown = import_UIObject.NO;
       if (!this._selectedItem) {
+        this._isProgrammaticTextChange = import_UIObject.YES;
         this.text = "";
+        this._isProgrammaticTextChange = import_UIObject.NO;
       }
       this.openDropdown();
       this.textElementView.viewHTMLElement.select();
@@ -59,6 +64,9 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
     };
     this.addTargetForControlEvent(import_UITextField.UITextField.controlEvent.TextChange, () => {
       this._selectedItem = void 0;
+      if (!this._isProgrammaticTextChange) {
+        this._userHasNavigatedDropdown = this.text.length > 0;
+      }
       this.updateFilteredItems();
       if (!this._isDropdownOpen) {
         this.openDropdown();
@@ -70,6 +78,7 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
         this.openDropdown();
         return;
       }
+      this._userHasNavigatedDropdown = import_UIObject.YES;
       const maxIndex = this._dropdownView.filteredItems.length - 1;
       if (this._dropdownView.highlightedRowIndex < maxIndex) {
         this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex + 1;
@@ -77,6 +86,7 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
     });
     this.textElementView.addTargetForControlEvent(import_UIView.UIView.controlEvent.UpArrowDown, (sender, event) => {
       event.preventDefault();
+      this._userHasNavigatedDropdown = import_UIObject.YES;
       if (this._dropdownView.highlightedRowIndex > 0) {
         this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex - 1;
       }
@@ -92,7 +102,7 @@ const _UIAutocompleteTextField = class extends import_UITextField.UITextField {
     this.addTargetForControlEvent(import_UIView.UIView.controlEvent.TabDown, (sender, event) => {
       if (this._isDropdownOpen) {
         const highlightedItem = this._dropdownView.highlightedItem;
-        if ((0, import_UIObject.IS)(highlightedItem)) {
+        if ((0, import_UIObject.IS)(highlightedItem) && this._userHasNavigatedDropdown) {
           this.commitSelection(highlightedItem);
         } else {
           this.closeDropdown();

package/compiledScripts/UIAutocompleteTextField.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../scripts/UIAutocompleteTextField.ts"],
-  "sourcesContent": ["import { UIAutocompleteDropdownView } from \"./UIAutocompleteDropdownView\"\nimport { UIAutocompleteItem } from \"./UIAutocompleteRowView\"\nimport { IS, IS_NOT, NO, YES } from \"./UIObject\"\nimport { UITextField } from \"./UITextField\"\nimport { UIView, UIViewAddControlEventTargetObject } from \"./UIView\"\n\n\nexport class UIAutocompleteTextField<T = string> extends UITextField {\n    \n    _autocompleteItems: UIAutocompleteItem<T>[] = []\n    _selectedItem?: UIAutocompleteItem<T>\n    _dropdownView: UIAutocompleteDropdownView<T>\n    _isDropdownOpen: boolean = NO\n    _strictSelection: boolean = NO\n    _isValid: boolean = YES\n    \n    /**\n     * When YES, the filter text is split on whitespace and all words must appear\n     * in the item label (AND logic). When NO (default), the full filter string is\n     * matched as a single substring.\n     */\n    usesMultiWordAndSearch: boolean = NO\n    \n    \n    static override controlEvent = Object.assign({}, UITextField.controlEvent, {\n        \"SelectionDidChange\": \"SelectionDidChange\"\n    })\n    \n    override get controlEventTargetAccumulator(): UIViewAddControlEventTargetObject<typeof UIAutocompleteTextField> {\n        return (super.controlEventTargetAccumulator as any)\n    }\n    \n    \n    constructor(elementID?: string) {\n        \n        super(elementID)\n        \n        this._dropdownView = this.newDropdownView()\n        \n        this._dropdownView.didSelectItem = (item) => {\n            this.commitSelection(item)\n        }\n        \n        let textBeforeFocus = this.text\n        let itemBeforeFocus = this.selectedItem\n        \n        // Open dropdown on focus.\n        // If a selection is already committed we keep the confirmed text visible\n        // and do not clear it \u2014 this covers Tab-into-field after a prior selection,\n        // as well as returning focus after commitSelection.\n        this.controlEventTargetAccumulator.Focus = () => {\n            textBeforeFocus = this.text\n            itemBeforeFocus = this.selectedItem\n            if (!this._selectedItem) {\n                this.text = \"\"\n            }\n            this.openDropdown()\n            this.textElementView.viewHTMLElement.select()\n            const matchIndex = this._dropdownView.filteredItems.findIndex(\n                item => item.label === textBeforeFocus\n            )\n            if (matchIndex !== -1) {\n                this._dropdownView.highlightedRowIndex = matchIndex\n            }\n        }\n        \n        // Close on blur\n        this.controlEventTargetAccumulator.Blur = () => {\n            this.closeDropdown()\n        }\n        \n        // Filter on text change\n        this.addTargetForControlEvent(UITextField.controlEvent.TextChange, () => {\n            this._selectedItem = undefined\n            this.updateFilteredItems()\n            if (!this._isDropdownOpen) {\n                this.openDropdown()\n            }\n        })\n        \n        // Keyboard navigation: down arrow\n        this.textElementView.addTargetForControlEvent(UIView.controlEvent.DownArrowDown, (sender, event) => {\n            event.preventDefault()\n            if (!this._isDropdownOpen) {\n                this.openDropdown()\n                return\n            }\n            const maxIndex = this._dropdownView.filteredItems.length - 1\n            if (this._dropdownView.highlightedRowIndex < maxIndex) {\n                this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex + 1\n            }\n        })\n        \n        // Keyboard navigation: up arrow\n        this.textElementView.addTargetForControlEvent(UIView.controlEvent.UpArrowDown, (sender, event) => {\n            event.preventDefault()\n            if (this._dropdownView.highlightedRowIndex > 0) {\n                this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex - 1\n            }\n        })\n        \n        // Enter: commit focused item\n        this.addTargetForControlEvent(UIView.controlEvent.EnterDown, () => {\n            const highlightedItem = this._dropdownView.highlightedItem\n            if (IS(highlightedItem)) {\n                this.commitSelection(highlightedItem)\n            }\n            else if (this._isDropdownOpen) {\n                this.closeDropdown()\n            }\n        })\n        \n        // Tab: commit highlighted item if dropdown is open, then let focus move\n        // naturally to the next item in the managed sequence.\n        this.addTargetForControlEvent(UIView.controlEvent.TabDown, (sender, event) => {\n            if (this._isDropdownOpen) {\n                const highlightedItem = this._dropdownView.highlightedItem\n                if (IS(highlightedItem)) {\n                    this.commitSelection(highlightedItem)\n                }\n                else {\n                    this.closeDropdown()\n                }\n            }\n        })\n        \n        // Escape: dismiss dropdown\n        this.addTargetForControlEvent(UIView.controlEvent.EscDown, () => {\n            if (this._isDropdownOpen) {\n                this.closeDropdown()\n                if (this.strictSelection) {\n                    this.commitSelection(itemBeforeFocus as any)\n                }\n                else {\n                    this.text = textBeforeFocus\n                }\n            }\n        })\n        \n    }\n    \n    \n    /** Override in subclass to provide a custom dropdown view. */\n    newDropdownView(): UIAutocompleteDropdownView<T> {\n        return new UIAutocompleteDropdownView<T>(\n            this.elementID ? this.elementID + \"Dropdown\" : undefined\n        )\n    }\n    \n    \n    // MARK: - Selection\n    \n    get selectedItem(): T | undefined {\n        return this._selectedItem?.value\n    }\n    \n    \n    get strictSelection(): boolean {\n        return this._strictSelection\n    }\n    \n    set strictSelection(strict: boolean) {\n        this._strictSelection = strict\n        this.updateValidationVisuals()\n    }\n    \n    \n    commitSelection(item: UIAutocompleteItem<T>) {\n        \n        // Set the selection state and close the dropdown without blurring.\n        // Keeping focus on this view means the next Tab press is handled by\n        // our TabDown handler rather than being picked up natively by the browser.\n        this._selectedItem = item\n        this.text = item.label\n        this.closeDropdown()\n        this.updateValidationVisuals()\n        this.sendControlEventForKey(UIAutocompleteTextField.controlEvent.SelectionDidChange)\n        \n    }\n    \n    \n    // MARK: - Data\n    \n    /** Convenience: set string suggestions. Each string becomes { label: s, value: s }. */\n    set autocompleteStrings(strings: string[]) {\n        this._autocompleteItems = strings.map(s => ({\n            label: s,\n            value: s as unknown as T\n        }))\n        this.updateFilteredItems()\n    }\n    \n    get autocompleteStrings(): string[] {\n        return this._autocompleteItems.map(item => item.label)\n    }\n    \n    set autocompleteData(items: UIAutocompleteItem<T>[]) {\n        this._autocompleteItems = items\n        this.updateFilteredItems()\n    }\n    \n    get autocompleteData(): UIAutocompleteItem<T>[] {\n        return this._autocompleteItems\n    }\n    \n    \n    // MARK: - Filtering\n    \n    /**\n     * Splits the given lowercase-trimmed filter text into individual words when\n     * usesMultiWordAndSearch is YES, or returns it as a single-element array otherwise.\n     * Returns an empty array when the input is empty.\n     */\n    _filterWordsFromText(filterText: string): string[] {\n        if (filterText.length === 0) {\n            return []\n        }\n        if (this.usesMultiWordAndSearch) {\n            return filterText.split(/\\s+/).filter(word => word.length > 0)\n        }\n        return [filterText]\n    }\n    \n    \n    /**\n     * Returns true when the given label (already lowercased) satisfies all filter\n     * words \u2014 i.e. every word appears somewhere in the label.\n     */\n    _labelMatchesFilterWords(label: string, filterWords: string[]): boolean {\n        return filterWords.every(word => label.includes(word))\n    }\n    \n    \n    /**\n     * Returns true when the character immediately before `position` in `label`\n     * is a word separator (or the position is at the start of the string).\n     * Used to give a bonus to matches that start at a word boundary.\n     */\n    _isWordBoundary(label: string, position: number): boolean {\n        if (position === 0) {\n            return YES\n        }\n        const charBefore = label[position - 1]\n        return \" -/\\\\|._,;:()[]\".includes(charBefore)\n    }\n    \n    \n    /**\n     * Scores a label against the filter words. Lower score = better match.\n     *\n     * Scoring factors (in priority order):\n     *   1. Non-sequential penalty \u2014 words must appear in typed order to avoid\n     *      a large penalty that pushes them below all sequential matches.\n     *   2. Per-word boundary score \u2014 for each filter word, a mid-word match\n     *      scores worse than a word-boundary match. The sum across all words\n     *      determines the boundary tier.\n     *   3. Position of the first matched word \u2014 within the same boundary tier,\n     *      earlier appearances rank higher.\n     *   4. Total label length \u2014 shorter labels are more specific (tiebreaker).\n     *\n     * Example: query \"p\u00F5 pu\"\n     *   \"P\u00F5hjavee puhastusvahendid\"   \u2192 \"p\u00F5\" at boundary(0), \"pu\" at boundary(9) \u2192 low boundary score\n     *   \"p\u00F5randapuhastusvahendid\"     \u2192 \"p\u00F5\" at boundary(0), \"pu\" mid-word(7)    \u2192 higher boundary score\n     *   \u2192 \"P\u00F5hjavee puhastusvahendid\" ranks first.\n     */\n    _scoreLabel(label: string, filterWords: string[]): number {\n        \n        if (filterWords.length === 0) {\n            return label.length\n        }\n        \n        // --- Sequential check ---\n        // Scan left-to-right; if all words appear in order record the positions.\n        let cursor = 0\n        let isSequential = YES\n        const sequentialPositions: number[] = []\n        for (const word of filterWords) {\n            const position = label.indexOf(word, cursor)\n            if (position === -1) {\n                isSequential = NO\n                break\n            }\n            sequentialPositions.push(position)\n            cursor = position + word.length\n        }\n        \n        // --- Boundary score ---\n        // For each filter word find its best (leftmost) match and check whether\n        // it lands on a word boundary. Non-boundary matches incur a per-word\n        // penalty of 1, so the boundary score is 0..filterWords.length.\n        let boundaryScore = 0\n        for (const word of filterWords) {\n            const position = label.indexOf(word)\n            if (position !== -1 && !this._isWordBoundary(label, position)) {\n                boundaryScore += 1\n            }\n        }\n        \n        // Position of the first word's earliest match.\n        const firstMatchPosition = label.indexOf(filterWords[0])\n        \n        // Compose score \u2014 each tier must not overflow into the next:\n        //   Non-sequential penalty : 10 000 000  (dominates everything)\n        //   Boundary score         :     10 000  (per word, max ~10 words \u2192 100 000 max, safe)\n        //   First-match position   :        100  (labels rarely exceed 200 chars)\n        //   Label length           :          1  (tiebreaker)\n        const sequentialPenalty = isSequential ? 0 : 10_000_000\n        \n        return sequentialPenalty +\n            boundaryScore * 10_000 +\n            firstMatchPosition * 100 +\n            label.length\n        \n    }\n    \n    \n    updateFilteredItems() {\n        \n        const rawFilterText = this.text.toLowerCase().trim()\n        const filterWords = this._filterWordsFromText(rawFilterText)\n        \n        let filtered: UIAutocompleteItem<T>[]\n        \n        if (filterWords.length === 0) {\n            filtered = this._autocompleteItems\n        }\n        else {\n            filtered = this._autocompleteItems\n                .filter(item => this._labelMatchesFilterWords(item.label.toLowerCase(), filterWords))\n                .map((item, originalIndex) => ({ item, originalIndex, score: this._scoreLabel(item.label.toLowerCase(), filterWords) }))\n                .sort((a, b) => a.score - b.score || a.originalIndex - b.originalIndex)\n                .map(({ item }) => item)\n        }\n        \n        // If the only remaining result is an exact match for the current text,\n        // the user has already made their selection \u2014 no need to show the dropdown.\n        const isExactSingleMatch = filtered.length === 1 &&\n            filtered[0].label.toLowerCase() === rawFilterText\n        \n        this._dropdownView.filterWords = filterWords\n        this._dropdownView.filteredItems = isExactSingleMatch ? [] : filtered\n        \n        if (this._dropdownView.filteredItems.length > 0) {\n            this._dropdownView.highlightedRowIndex = 0\n        }\n        \n        if (this._isDropdownOpen) {\n            this._dropdownView.showAnchoredToView(this)\n        }\n        \n    }\n    \n    \n    // MARK: - Dropdown Lifecycle\n    \n    openDropdown() {\n        \n        if (this._isDropdownOpen) {\n            return\n        }\n        \n        this._isDropdownOpen = YES\n        this._dropdownView.filterWords = []\n        this.updateFilteredItems()\n        this._dropdownView.showAnchoredToView(this)\n        \n    }\n    \n    closeDropdown() {\n        \n        if (!this._isDropdownOpen) {\n            return\n        }\n        \n        this._isDropdownOpen = NO\n        this._dropdownView.dismiss()\n        \n        // In strict mode, clear text if it doesn't match any item\n        if (this._strictSelection && IS_NOT(this._selectedItem)) {\n            const currentText = this.text.trim()\n            if (currentText.length > 0) {\n                const matchingItem = this._autocompleteItems.find(\n                    item => item.label === currentText\n                )\n                if (IS(matchingItem)) {\n                    this._selectedItem = matchingItem\n                }\n                else {\n                    this.text = \"\"\n                    this._selectedItem = undefined\n                }\n            }\n        }\n        \n        this.updateValidationVisuals()\n        \n    }\n    \n    \n    // MARK: - Validation\n    \n    /** Whether the current text is valid given the strictSelection setting. */\n    get isValid(): boolean {\n        \n        if (!this._strictSelection) {\n            return YES\n        }\n        \n        const currentText = this.text.trim()\n        \n        if (currentText.length === 0) {\n            return YES\n        }\n        \n        return this._autocompleteItems.some(item => item.label === currentText)\n        \n    }\n    \n    \n    /**\n     * Hook for subclasses to apply custom visual styling based on validation state.\n     * Called after dropdown closes and after selection changes.\n     */\n    updateValidationVisuals() {\n        // Base implementation does nothing. Subclasses override.\n    }\n    \n    \n    // MARK: - Cleanup\n    \n    override wasRemovedFromViewTree() {\n        \n        super.wasRemovedFromViewTree()\n        \n        this._dropdownView.removeFromSuperview()\n        \n    }\n    \n    \n    // MARK: - Layout\n    \n    override layoutSubviews() {\n        \n        super.layoutSubviews()\n        \n        if (this._isDropdownOpen) {\n            this._dropdownView.showAnchoredToView(this)\n        }\n        \n    }\n    \n    \n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { UIAutocompleteDropdownView } from \"./UIAutocompleteDropdownView\"\nimport { UIAutocompleteItem } from \"./UIAutocompleteRowView\"\nimport { IS, IS_NOT, NO, YES } from \"./UIObject\"\nimport { UITextField } from \"./UITextField\"\nimport { UIView, UIViewAddControlEventTargetObject } from \"./UIView\"\n\n\nexport class UIAutocompleteTextField<T = string> extends UITextField {\n    \n    _autocompleteItems: UIAutocompleteItem<T>[] = []\n    _selectedItem?: UIAutocompleteItem<T>\n    _dropdownView: UIAutocompleteDropdownView<T>\n    _isDropdownOpen: boolean = NO\n    _strictSelection: boolean = NO\n    _isValid: boolean = YES\n    // Set to YES only when the user has explicitly interacted with the dropdown\n    // (typed text or navigated with arrow keys). Prevents Tab-to-focus from\n    // auto-committing the first item.\n    _userHasNavigatedDropdown: boolean = NO\n    // Set to YES while we are programmatically clearing the text field on focus\n    // so the TextChange handler does not treat it as a user-initiated change.\n    _isProgrammaticTextChange: boolean = NO\n    \n    /**\n     * When YES, the filter text is split on whitespace and all words must appear\n     * in the item label (AND logic). When NO (default), the full filter string is\n     * matched as a single substring.\n     */\n    usesMultiWordAndSearch: boolean = NO\n    \n    \n    static override controlEvent = Object.assign({}, UITextField.controlEvent, {\n        \"SelectionDidChange\": \"SelectionDidChange\"\n    })\n    \n    override get controlEventTargetAccumulator(): UIViewAddControlEventTargetObject<typeof UIAutocompleteTextField> {\n        return (super.controlEventTargetAccumulator as any)\n    }\n    \n    \n    constructor(elementID?: string) {\n        \n        super(elementID)\n        \n        this._dropdownView = this.newDropdownView()\n        \n        this._dropdownView.didSelectItem = (item) => {\n            this.commitSelection(item)\n        }\n        \n        let textBeforeFocus = this.text\n        let itemBeforeFocus = this.selectedItem\n        \n        // Open dropdown on focus.\n        // If a selection is already committed we keep the confirmed text visible\n        // and do not clear it \u2014 this covers Tab-into-field after a prior selection,\n        // as well as returning focus after commitSelection.\n        this.controlEventTargetAccumulator.Focus = () => {\n            textBeforeFocus = this.text\n            itemBeforeFocus = this.selectedItem\n            this._userHasNavigatedDropdown = NO\n            if (!this._selectedItem) {\n                this._isProgrammaticTextChange = YES\n                this.text = \"\"\n                this._isProgrammaticTextChange = NO\n            }\n            this.openDropdown()\n            this.textElementView.viewHTMLElement.select()\n            const matchIndex = this._dropdownView.filteredItems.findIndex(\n                item => item.label === textBeforeFocus\n            )\n            if (matchIndex !== -1) {\n                this._dropdownView.highlightedRowIndex = matchIndex\n            }\n        }\n        \n        // Close on blur\n        this.controlEventTargetAccumulator.Blur = () => {\n            this.closeDropdown()\n        }\n        \n        // Filter on text change\n        this.addTargetForControlEvent(UITextField.controlEvent.TextChange, () => {\n            this._selectedItem = undefined\n            if (!this._isProgrammaticTextChange) {\n                this._userHasNavigatedDropdown = this.text.length > 0\n            }\n            this.updateFilteredItems()\n            if (!this._isDropdownOpen) {\n                this.openDropdown()\n            }\n        })\n        \n        // Keyboard navigation: down arrow\n        this.textElementView.addTargetForControlEvent(UIView.controlEvent.DownArrowDown, (sender, event) => {\n            event.preventDefault()\n            if (!this._isDropdownOpen) {\n                this.openDropdown()\n                return\n            }\n            this._userHasNavigatedDropdown = YES\n            const maxIndex = this._dropdownView.filteredItems.length - 1\n            if (this._dropdownView.highlightedRowIndex < maxIndex) {\n                this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex + 1\n            }\n        })\n        \n        // Keyboard navigation: up arrow\n        this.textElementView.addTargetForControlEvent(UIView.controlEvent.UpArrowDown, (sender, event) => {\n            event.preventDefault()\n            this._userHasNavigatedDropdown = YES\n            if (this._dropdownView.highlightedRowIndex > 0) {\n                this._dropdownView.highlightedRowIndex = this._dropdownView.highlightedRowIndex - 1\n            }\n        })\n        \n        // Enter: commit focused item\n        this.addTargetForControlEvent(UIView.controlEvent.EnterDown, () => {\n            const highlightedItem = this._dropdownView.highlightedItem\n            if (IS(highlightedItem)) {\n                this.commitSelection(highlightedItem)\n            }\n            else if (this._isDropdownOpen) {\n                this.closeDropdown()\n            }\n        })\n        \n        // Tab: commit highlighted item only if the user has explicitly interacted\n        // with the dropdown (typed or used arrow keys). This prevents tabbing\n        // through the form from silently committing the first suggestion.\n        this.addTargetForControlEvent(UIView.controlEvent.TabDown, (sender, event) => {\n            if (this._isDropdownOpen) {\n                const highlightedItem = this._dropdownView.highlightedItem\n                if (IS(highlightedItem) && this._userHasNavigatedDropdown) {\n                    this.commitSelection(highlightedItem)\n                }\n                else {\n                    this.closeDropdown()\n                }\n            }\n        })\n        \n        // Escape: dismiss dropdown\n        this.addTargetForControlEvent(UIView.controlEvent.EscDown, () => {\n            if (this._isDropdownOpen) {\n                this.closeDropdown()\n                if (this.strictSelection) {\n                    this.commitSelection(itemBeforeFocus as any)\n                }\n                else {\n                    this.text = textBeforeFocus\n                }\n            }\n        })\n        \n    }\n    \n    \n    /** Override in subclass to provide a custom dropdown view. */\n    newDropdownView(): UIAutocompleteDropdownView<T> {\n        return new UIAutocompleteDropdownView<T>(\n            this.elementID ? this.elementID + \"Dropdown\" : undefined\n        )\n    }\n    \n    \n    // MARK: - Selection\n    \n    get selectedItem(): T | undefined {\n        return this._selectedItem?.value\n    }\n    \n    \n    get strictSelection(): boolean {\n        return this._strictSelection\n    }\n    \n    set strictSelection(strict: boolean) {\n        this._strictSelection = strict\n        this.updateValidationVisuals()\n    }\n    \n    \n    commitSelection(item: UIAutocompleteItem<T>) {\n        \n        // Set the selection state and close the dropdown without blurring.\n        // Keeping focus on this view means the next Tab press is handled by\n        // our TabDown handler rather than being picked up natively by the browser.\n        this._selectedItem = item\n        this.text = item.label\n        this.closeDropdown()\n        this.updateValidationVisuals()\n        this.sendControlEventForKey(UIAutocompleteTextField.controlEvent.SelectionDidChange)\n        \n    }\n    \n    \n    // MARK: - Data\n    \n    /** Convenience: set string suggestions. Each string becomes { label: s, value: s }. */\n    set autocompleteStrings(strings: string[]) {\n        this._autocompleteItems = strings.map(s => ({\n            label: s,\n            value: s as unknown as T\n        }))\n        this.updateFilteredItems()\n    }\n    \n    get autocompleteStrings(): string[] {\n        return this._autocompleteItems.map(item => item.label)\n    }\n    \n    set autocompleteData(items: UIAutocompleteItem<T>[]) {\n        this._autocompleteItems = items\n        this.updateFilteredItems()\n    }\n    \n    get autocompleteData(): UIAutocompleteItem<T>[] {\n        return this._autocompleteItems\n    }\n    \n    \n    // MARK: - Filtering\n    \n    /**\n     * Splits the given lowercase-trimmed filter text into individual words when\n     * usesMultiWordAndSearch is YES, or returns it as a single-element array otherwise.\n     * Returns an empty array when the input is empty.\n     */\n    _filterWordsFromText(filterText: string): string[] {\n        if (filterText.length === 0) {\n            return []\n        }\n        if (this.usesMultiWordAndSearch) {\n            return filterText.split(/\\s+/).filter(word => word.length > 0)\n        }\n        return [filterText]\n    }\n    \n    \n    /**\n     * Returns true when the given label (already lowercased) satisfies all filter\n     * words \u2014 i.e. every word appears somewhere in the label.\n     */\n    _labelMatchesFilterWords(label: string, filterWords: string[]): boolean {\n        return filterWords.every(word => label.includes(word))\n    }\n    \n    \n    /**\n     * Returns true when the character immediately before `position` in `label`\n     * is a word separator (or the position is at the start of the string).\n     * Used to give a bonus to matches that start at a word boundary.\n     */\n    _isWordBoundary(label: string, position: number): boolean {\n        if (position === 0) {\n            return YES\n        }\n        const charBefore = label[position - 1]\n        return \" -/\\\\|._,;:()[]\".includes(charBefore)\n    }\n    \n    \n    /**\n     * Scores a label against the filter words. Lower score = better match.\n     *\n     * Scoring factors (in priority order):\n     *   1. Non-sequential penalty \u2014 words must appear in typed order to avoid\n     *      a large penalty that pushes them below all sequential matches.\n     *   2. Per-word boundary score \u2014 for each filter word, a mid-word match\n     *      scores worse than a word-boundary match. The sum across all words\n     *      determines the boundary tier.\n     *   3. Position of the first matched word \u2014 within the same boundary tier,\n     *      earlier appearances rank higher.\n     *   4. Total label length \u2014 shorter labels are more specific (tiebreaker).\n     *\n     * Example: query \"p\u00F5 pu\"\n     *   \"P\u00F5hjavee puhastusvahendid\"   \u2192 \"p\u00F5\" at boundary(0), \"pu\" at boundary(9) \u2192 low boundary score\n     *   \"p\u00F5randapuhastusvahendid\"     \u2192 \"p\u00F5\" at boundary(0), \"pu\" mid-word(7)    \u2192 higher boundary score\n     *   \u2192 \"P\u00F5hjavee puhastusvahendid\" ranks first.\n     */\n    _scoreLabel(label: string, filterWords: string[]): number {\n        \n        if (filterWords.length === 0) {\n            return label.length\n        }\n        \n        // --- Sequential check ---\n        // Scan left-to-right; if all words appear in order record the positions.\n        let cursor = 0\n        let isSequential = YES\n        const sequentialPositions: number[] = []\n        for (const word of filterWords) {\n            const position = label.indexOf(word, cursor)\n            if (position === -1) {\n                isSequential = NO\n                break\n            }\n            sequentialPositions.push(position)\n            cursor = position + word.length\n        }\n        \n        // --- Boundary score ---\n        // For each filter word find its best (leftmost) match and check whether\n        // it lands on a word boundary. Non-boundary matches incur a per-word\n        // penalty of 1, so the boundary score is 0..filterWords.length.\n        let boundaryScore = 0\n        for (const word of filterWords) {\n            const position = label.indexOf(word)\n            if (position !== -1 && !this._isWordBoundary(label, position)) {\n                boundaryScore += 1\n            }\n        }\n        \n        // Position of the first word's earliest match.\n        const firstMatchPosition = label.indexOf(filterWords[0])\n        \n        // Compose score \u2014 each tier must not overflow into the next:\n        //   Non-sequential penalty : 10 000 000  (dominates everything)\n        //   Boundary score         :     10 000  (per word, max ~10 words \u2192 100 000 max, safe)\n        //   First-match position   :        100  (labels rarely exceed 200 chars)\n        //   Label length           :          1  (tiebreaker)\n        const sequentialPenalty = isSequential ? 0 : 10_000_000\n        \n        return sequentialPenalty +\n            boundaryScore * 10_000 +\n            firstMatchPosition * 100 +\n            label.length\n        \n    }\n    \n    \n    updateFilteredItems() {\n        \n        const rawFilterText = this.text.toLowerCase().trim()\n        const filterWords = this._filterWordsFromText(rawFilterText)\n        \n        let filtered: UIAutocompleteItem<T>[]\n        \n        if (filterWords.length === 0) {\n            filtered = this._autocompleteItems\n        }\n        else {\n            filtered = this._autocompleteItems\n                .filter(item => this._labelMatchesFilterWords(item.label.toLowerCase(), filterWords))\n                .map((item, originalIndex) => ({ item, originalIndex, score: this._scoreLabel(item.label.toLowerCase(), filterWords) }))\n                .sort((a, b) => a.score - b.score || a.originalIndex - b.originalIndex)\n                .map(({ item }) => item)\n        }\n        \n        // If the only remaining result is an exact match for the current text,\n        // the user has already made their selection \u2014 no need to show the dropdown.\n        const isExactSingleMatch = filtered.length === 1 &&\n            filtered[0].label.toLowerCase() === rawFilterText\n        \n        this._dropdownView.filterWords = filterWords\n        this._dropdownView.filteredItems = isExactSingleMatch ? [] : filtered\n        \n        if (this._dropdownView.filteredItems.length > 0) {\n            this._dropdownView.highlightedRowIndex = 0\n        }\n        \n        if (this._isDropdownOpen) {\n            this._dropdownView.showAnchoredToView(this)\n        }\n        \n    }\n    \n    \n    // MARK: - Dropdown Lifecycle\n    \n    openDropdown() {\n        \n        if (this._isDropdownOpen) {\n            return\n        }\n        \n        this._isDropdownOpen = YES\n        this._dropdownView.filterWords = []\n        this.updateFilteredItems()\n        this._dropdownView.showAnchoredToView(this)\n        \n    }\n    \n    closeDropdown() {\n        \n        if (!this._isDropdownOpen) {\n            return\n        }\n        \n        this._isDropdownOpen = NO\n        this._dropdownView.dismiss()\n        \n        // In strict mode, clear text if it doesn't match any item\n        if (this._strictSelection && IS_NOT(this._selectedItem)) {\n            const currentText = this.text.trim()\n            if (currentText.length > 0) {\n                const matchingItem = this._autocompleteItems.find(\n                    item => item.label === currentText\n                )\n                if (IS(matchingItem)) {\n                    this._selectedItem = matchingItem\n                }\n                else {\n                    this.text = \"\"\n                    this._selectedItem = undefined\n                }\n            }\n        }\n        \n        this.updateValidationVisuals()\n        \n    }\n    \n    \n    // MARK: - Validation\n    \n    /** Whether the current text is valid given the strictSelection setting. */\n    get isValid(): boolean {\n        \n        if (!this._strictSelection) {\n            return YES\n        }\n        \n        const currentText = this.text.trim()\n        \n        if (currentText.length === 0) {\n            return YES\n        }\n        \n        return this._autocompleteItems.some(item => item.label === currentText)\n        \n    }\n    \n    \n    /**\n     * Hook for subclasses to apply custom visual styling based on validation state.\n     * Called after dropdown closes and after selection changes.\n     */\n    updateValidationVisuals() {\n        // Base implementation does nothing. Subclasses override.\n    }\n    \n    \n    // MARK: - Cleanup\n    \n    override wasRemovedFromViewTree() {\n        \n        super.wasRemovedFromViewTree()\n        \n        this._dropdownView.removeFromSuperview()\n        \n    }\n    \n    \n    // MARK: - Layout\n    \n    override layoutSubviews() {\n        \n        super.layoutSubviews()\n        \n        if (this._isDropdownOpen) {\n            this._dropdownView.showAnchoredToView(this)\n        }\n        \n    }\n    \n    \n}\n"],
+  "mappings": "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",
   "names": []
 }

package/compiledScripts/UIView.d.ts

@@ -103,6 +103,9 @@ export declare class UIView extends UIObject {
         producer: () => string;
     }>;
     _liveCSSCallback: () => void;
+    _overlayView?: UIView;
+    get overlayView(): UIView | undefined;
+    set overlayView(view: UIView);
     _viewHTMLElement: HTMLElement & LooseObject;
     _innerHTMLKey?: string;
     _defaultInnerHTML?: string;

package/compiledScripts/UIView.js

@@ -122,6 +122,18 @@ const _UIView = class extends import_UIObject.UIObject {
     this._loadUIEvents();
     this.setNeedsLayout();
   }
+  get overlayView() {
+    return this._overlayView;
+  }
+  set overlayView(view) {
+    var _a;
+    if ((0, import_UIObject.IS)(view)) {
+      this.addSubview(view);
+    } else {
+      (_a = this._overlayView) == null ? void 0 : _a.removeFromSuperview();
+    }
+    this._overlayView = view;
+  }
   set loading(isLoading) {
     var _a;
     this.userInteractionEnabled = !isLoading;
@@ -654,7 +666,8 @@ const _UIView = class extends import_UIObject.UIObject {
         this.frameTransform
       );
     }
-    if (frame.height != rectangle.height || frame.width != rectangle.width || performUncheckedLayout) {
+    const haveBoundsChanged = frame.height.integerValue != rectangle.height.integerValue || frame.width.integerValue != rectangle.width.integerValue;
+    if (haveBoundsChanged || performUncheckedLayout) {
       this.setNeedsLayout();
       this.boundsDidChange(this.bounds);
     }
@@ -1181,6 +1194,9 @@ const _UIView = class extends import_UIObject.UIObject {
       subview.calculateAndSetViewFrame();
     }
     this.didLayoutSubviews();
+    if (this._overlayView) {
+      this._overlayView.weakFrame = this.bounds;
+    }
   }
   applyClassesAndStyles() {
     for (let i = 0; i < this.styleClasses.length; i++) {