@orangelogic/design-system 2.0.0-29DUO2-beta-3 → 2.0.0-29IORR-beta-2

package/library/components/visually-hidden.js

@@ -1,20 +1,8 @@
 import { C as a } from "../chunks/lib-cortex-element.CVMmyPMC.js";
-import { c as l } from "../chunks/component.styles.DMSLciL5.js";
+import { c as l } from "../chunks/component.styles.CRO4Odto.js";
 import { c as m } from "../chunks/custom-element.L4WJXn1j.js";
 import { i as c, x as d } from "../chunks/lit-element.jLBm65_O.js";
-const h = c`
-  :host(:not(:focus-within)) {
-    position: absolute !important;
-    width: 1px !important;
-    height: 1px !important;
-    clip: rect(0 0 0 0) !important;
-    clip-path: inset(50%) !important;
-    border: none !important;
-    overflow: hidden !important;
-    white-space: nowrap !important;
-    padding: 0 !important;
-  }
-`;
+const h = c`:host(:not(:focus-within)){clip:rect(0 0 0 0)!important;clip-path:inset(50%)!important;white-space:nowrap!important;border:none!important;width:1px!important;height:1px!important;padding:0!important;position:absolute!important;overflow:hidden!important}`;
 var f = Object.getOwnPropertyDescriptor, u = (r, n, p, i) => {
   for (var t = i > 1 ? void 0 : i ? f(n, p) : n, o = r.length - 1, s; o >= 0; o--)
     (s = r[o]) && (t = s(t) || t);
@@ -22,7 +10,7 @@ var f = Object.getOwnPropertyDescriptor, u = (r, n, p, i) => {
 };
 let e = class extends a {
   render() {
-    return d` <slot></slot> `;
+    return d`<slot></slot>`;
   }
 };
 e.styles = [l, h];

package/library/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orangelogic/design-system",
   "type": "module",
-  "version": "2.0.0-29DUO2-beta-3",
+  "version": "2.0.0-29IORR-beta-2",
   "license": "UNLICENSED",
   "types": "library/types.d.ts",
   "scripts": {
@@ -45,5 +45,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "nx": {
+    "projectType": "application"
   }
 }

package/library/packages/atoms/src/components/dialog/dialog.d.ts

@@ -2,6 +2,7 @@ import { default as CortexElement } from '../../../../base/src/cortex-element.ts
 import { DialogDividerPosition } from '../../../../types/src/dialog';
 import { default as Modal } from '../../../../utils/src/custom-element/modal';
 import { CSSResultGroup, PropertyValues } from 'lit';
+import { ScrollbarsAutoHideBehavior } from 'overlayscrollbars';
 import { default as CxDivider } from '../divider/divider';
 import { default as CxIconButton } from '../icon-button/icon-button';
 import { default as CxPopup } from '../popup/popup';
@@ -103,8 +104,17 @@ export default class CxDialog extends CortexElement {
     /**
      * Enables the overlay scrollbar plugin, which provides a custom scrollbar that does not take up any content space.
      * This is useful for dialogs that contain scrollable content.
+     * Note that the scrollbar will only be visible when the content is overflowing.
      */
     useOverlayScrollbar: boolean;
+    /**
+     * The `autoHide` behavior of the overlay scrollbar. This controls when the scrollbar will be hidden. It can be set to 'scroll' (the default), which will hide the scrollbar when not scrolling, 'leave' which will hide the scrollbar when not scrolling and the mouse is not over the scrollable area, or 'never' which will never hide the scrollbar.
+     */
+    overlayScrollbarAutoHide: ScrollbarsAutoHideBehavior;
+    /**
+     * The `autoHideDelay` of the overlay scrollbar. This controls how long to wait before hiding the scrollbar when `autoHide` is set to 'scroll' or 'leave'. The default is 1000ms.
+     */
+    overlayScrollbarAutoHideDelay: number;
     /**
      * Preventing the dialog from closing when clicking the overlay.
      */

package/library/packages/atoms/src/components/icon-button/icon-button.d.ts

@@ -1,5 +1,6 @@
 import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
 import { ButtonVariant } from '../../../../types/src/button';
+import { IconButtonSize } from '../../../../types/src/icon-button';
 import { CSSResultGroup } from 'lit';
 import { default as CxIcon } from '../icon/icon';
 import { default as CxSpinner } from '../spinner/spinner';
@@ -73,7 +74,7 @@ export default class CxIconButton extends CortexElement {
     /**
      * The button's size.
      */
-    size: 'small' | 'medium' | 'large' | 'x-large';
+    size: IconButtonSize;
     /**
      * Draws an outlined button.
      */

package/library/packages/atoms/src/components/image/image.d.ts

@@ -29,7 +29,7 @@ import { default as CxSpace } from '../space/space';
  * @cssproperty --border - The border of the image.
  *
  * @event cx-load - Emitted when the image has loaded.
- * @event cx-error - Emitted when the image has failed to load.
+ * @event cx-error - Emitted when the image has failed to load (after all retry attempts when `retry-on-error` is enabled).
  * @event cx-image-zoom-open - Emitted when the image zoom is opened.
  * @event cx-image-zoom-close - Emitted when the image zoom is closed.
  *
@@ -49,8 +49,12 @@ export default class CxImage extends ResizableElement {
     imageElement?: HTMLImageElement;
     zoomImageElement: HTMLImageElement;
     highlighterElement: HTMLDivElement;
+    private _retryCount;
+    private _retryTimer;
     isLoaded: boolean;
     isError: boolean;
+    /** Incremented on each retry attempt to force the img element to remount via keyed(). */
+    private _retryIndex;
     /**
      * The path to the image to load.
      */
@@ -97,6 +101,14 @@ export default class CxImage extends ResizableElement {
      * - manual: The click handler is manually handled by the parent element.
      */
     clickHandlerType: ClickHandlerType;
+    /**
+     * When true, automatically retries loading the image on error before showing the fallback.
+     */
+    retryOnError: boolean;
+    /**
+     * Maximum number of retry attempts when `retry-on-error` is enabled.
+     */
+    maxRetries: number;
     /**
      * Indicates whether the image is currently zoomed.
      */
@@ -145,6 +157,8 @@ export default class CxImage extends ResizableElement {
     handleCanZoomChange(): Promise<void>;
     handleObjectFitChange(): Promise<void>;
     handleSrcChange(): void;
+    private clearRetryTimer;
+    private scheduleRetry;
     private initZoom;
     protected handleLoad(event: Event): void;
     protected handleError(): void;

package/library/packages/atoms/src/components/input/auto-grow-controller.d.ts

@@ -0,0 +1,23 @@
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+
+interface AutoGrowHost extends ReactiveControllerHost {
+    autoGrow: boolean;
+    autoGrowMirror?: HTMLSpanElement;
+    input: HTMLInputElement;
+    placeholder: string;
+    type: string;
+    value: string;
+}
+/**
+ * Reactive controller that keeps `cx-input` width in sync with its content when auto-grow is enabled.
+ */
+export declare class AutoGrowController implements ReactiveController {
+    private readonly host;
+    constructor(host: AutoGrowHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    hostUpdated(): void;
+    sync(): void;
+    private measureWidth;
+}
+export {};

package/library/packages/atoms/src/components/input/input.d.ts

@@ -38,6 +38,7 @@ import { default as CxIcon } from '../icon/icon';
  * @csspart file-button - The 'Choose file' button.
  * @csspart file-result - The text that displays the selected file name.
  * @csspart character-count-text - The text that displays the character count.
+ * @cssproperty [--cx-input-auto-grow-min-width=0] - The minimum width used when `auto-grow` is enabled.
  */
 export default class CxInput extends CortexElement implements CortexFormControl {
     #private;
@@ -48,7 +49,9 @@ export default class CxInput extends CortexElement implements CortexFormControl
     private readonly formControlController;
     private readonly hasSlotController;
     private readonly localize;
+    private readonly autoGrowController;
     input: HTMLInputElement;
+    autoGrowMirror: HTMLSpanElement;
     inputContainer: HTMLElement;
     labelElement: HTMLElement;
     private hasFocus;
@@ -66,6 +69,11 @@ export default class CxInput extends CortexElement implements CortexFormControl
     name: string;
     /** The current value of the input, submitted as a name/value pair with form data. */
     value: string;
+    /**
+     * When enabled, the input width grows and shrinks with its current value.
+     * This only applies to non-file input types.
+     */
+    autoGrow: boolean;
     /** If used with mask, this stores the input's value, with fixed strings omitted. */
     unmaskedValue: string;
     /** The default value of the form control. Primarily used for resetting the form control. */
@@ -197,8 +205,7 @@ export default class CxInput extends CortexElement implements CortexFormControl
     /** Gets the validation message */
     get validationMessage(): string;
     constructor();
-    runConnectedCallback(): void;
-    runFirstUpdated(): void;
+    connectedUpdatedCallback(): void;
     disconnectedCallback(): void;
     initMaskInstance(): Promise<void>;
     private handleBlur;
@@ -215,6 +222,7 @@ export default class CxInput extends CortexElement implements CortexFormControl
     handleDisabledChange(): void;
     handleStepChange(): void;
     handleValueChange(): Promise<void>;
+    handleAutoGrowChange(): Promise<void>;
     /** Sets focus on the input. */
     focus(options?: FocusOptions): void;
     /** Removes focus from the input. */

package/library/packages/atoms/src/components/menu-item/menu-item.d.ts

@@ -1,4 +1,5 @@
 import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
+import { MenuItemCheckPlacement } from '../../../../types/src/menu-item';
 import { CSSResultGroup, TemplateResult } from 'lit';
 import { default as CxIcon } from '../icon/icon';
 import { default as CxPopup } from '../popup/popup';
@@ -16,6 +17,7 @@ import { default as CxSpinner } from '../spinner/spinner';
  * @slot submenu-icon - The icon shown when the menu item has a submenu. Defaults to a chevron icon.
  *
  * @attr {string} submenu-placement - The placement of the submenu relative to the menu item. When not set, uses RTL-aware positioning ('left-start' in RTL, 'right-start' in LTR).
+ * @attr {'prefix' | 'suffix'} check-placement - Placement of the built-in checked icon relative to the label. Defaults to `suffix`. When set to `suffix` on an item that also has a submenu, the check icon renders after the submenu chevron.
  *
  * @csspart base - The component's base wrapper.
  * @csspart checked-icon - The checked icon, which is only visible when the menu item is checked.
@@ -76,6 +78,8 @@ export default class CxMenuItem extends CortexElement {
     menu: string;
     /** Whether to always show the checked icon. */
     alwaysShowCheckedIcon: boolean;
+    /** Placement of the built-in checked icon relative to the label. */
+    checkPlacement: MenuItemCheckPlacement;
     /** The placement of the submenu relative to the menu item. When null/undefined, uses RTL-aware default positioning. */
     submenuPlacement?: 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end' | 'right-start' | 'right-end';
     /** Enables lazy loading submenu behavior. */

package/library/packages/atoms/src/components/pagination/pagination.d.ts

@@ -1,8 +1,11 @@
+import { default as CxSpace } from '../space/space.ts';
 import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
+import { IconButtonSize } from '../../../../types/src/icon-button';
 import { PaginationCounter } from '../../../../types/src/pagination';
 import { CSSResultGroup, TemplateResult } from 'lit';
 import { default as CxButton } from '../button/button';
 import { default as CxIconButton } from '../icon-button/icon-button';
+import { default as CxInput } from '../input/input';
 import { default as CxOption } from '../option/option';
 import { default as CxSelect } from '../select/select';
 import { default as CxTooltip } from '../tooltip/tooltip';
@@ -10,6 +13,7 @@ import { default as CxTypography } from '../typography/typography';
 
 /**
  * @summary Pagination component displays the current page and allows the user to navigate through pages.
+ * @description Set `show-pagination-input` to render an editable page input in page counters. Leave it unset to keep the original plain-text counters. When only one page is available, navigation buttons are hidden and page counters remain plain text. Use `back-icon-name` and `next-icon-name` to override the previous/next icon-button glyphs (see the icon component for available names). Use `icon-button-size` for all navigation icon buttons (`small`, `medium`, `large`, `x-large`).
  *
  * @cssproperty --width - The width of the select
  *
@@ -22,8 +26,10 @@ export default class CxPagination extends CortexElement {
     static readonly dependencies: {
         'cx-button': typeof CxButton;
         'cx-icon-button': typeof CxIconButton;
+        'cx-input': typeof CxInput;
         'cx-option': typeof CxOption;
         'cx-select': typeof CxSelect;
+        'cx-space': typeof CxSpace;
         'cx-tooltip': typeof CxTooltip;
         'cx-typography': typeof CxTypography;
     };
@@ -63,28 +69,52 @@ export default class CxPagination extends CortexElement {
      * The type of pagination counter to display.
      */
     paginationCounter: PaginationCounter;
+    /**
+     * Whether to show an editable page input in page counters.
+     */
+    showPaginationInput: boolean;
+    /**
+     * Icon name for the previous (back) navigation button.
+     */
+    backIconName: string;
+    /**
+     * Icon name for the next navigation button.
+     */
+    nextIconName: string;
+    /**
+     * Size passed to each `cx-icon-button` in the navigation controls (first, previous, next, last).
+     */
+    iconButtonSize: IconButtonSize;
     private _pageIndex;
     private _pageCount;
+    /** Tracks the user-entered page value before committing navigation. */
+    private _pageInputValue;
     get pageIndex(): number;
     set pageIndex(value: number);
     get pageStart(): number;
     get pageEnd(): number;
     get prevDisabled(): boolean;
     get nextDisabled(): boolean;
+    private get hasMultiplePages();
     private updatePageCount;
     private handlePageSizeSelectChange;
     private handleFirst;
     private handleBack;
     private handleForward;
     private handleLast;
+    private commitPageInputValue;
+    private handlePageInput;
+    private handlePageInputKeyDown;
+    private handlePageInputBlur;
+    private renderCounterInput;
     handleCountChange(): Promise<void>;
     handlePageChange(): void;
     handlePageSizeChange(): void;
     private handlePageClick;
     private renderPageButton;
     private renderPageButtons;
-    renderPageCount(): TemplateResult<1>;
-    renderRowCount(): TemplateResult<1>;
+    private renderPageCount;
+    private renderRowCount;
     render(): TemplateResult;
 }
 declare global {

package/library/packages/atoms/src/components/popup/overlay/Overlay.d.ts

@@ -16,6 +16,9 @@ declare let OverlayFeatures: typeof AbstractOverlay & import('./overlay-types').
  * @fires cx-opened - announces that an overlay has completed any entry animations
  * @fires cx-closed - announce that an overlay has compelted any exit animations
  * @fires slottable-request - requests to add or remove slottable content
+ *
+ * @attr defer-slotted-visibility - when set, default-slot content stays visually hidden
+ * (layout preserved) until `state` is `opened`, avoiding flashes before top layer settles.
  */
 export declare class Overlay extends OverlayFeatures {
     static styles: CSSResultGroup;
@@ -30,6 +33,11 @@ export declare class Overlay extends OverlayFeatures {
     get delayed(): boolean;
     set delayed(delayed: boolean);
     private _delayed;
+    /**
+     * When true, slotted default content is not painted until `state === 'opened'`.
+     * Preserves layout (no `display: none`) so hosts can measure before reveal.
+     */
+    deferSlottedVisibility: boolean;
     dialogEl: HTMLDialogElement & {
         hidePopover(): void;
         showPopover(): void;
@@ -127,6 +135,8 @@ export declare class Overlay extends OverlayFeatures {
     protected updated(changes: PropertyValues): void;
     protected renderContent(): TemplateResult;
     private get dialogStyleMap();
+    /** Reveal deferred slotted content only after the overlay reaches the opened state. */
+    private get deferSlottedOpened();
     private handleClose;
     protected renderDialog(): TemplateResult;
     protected renderPopover(): TemplateResult;

package/library/packages/atoms/src/components/popup/popup.d.ts

@@ -45,7 +45,6 @@ export default class CxPopup extends CortexElement {
     /** A reference to the internal popup container. Useful for animating and styling the popup with JavaScript. */
     popup: HTMLElement;
     private arrowEl;
-    private overlay;
     /**
      * The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor
      * element `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the
@@ -168,6 +167,7 @@ export default class CxPopup extends CortexElement {
     disconnectedCallback(): void;
     connectedUpdatedCallback(): void;
     updated(changedProps: Map<string, unknown>): Promise<void>;
+    private handleOverlayOpened;
     private handleAnchorChange;
     private start;
     private stop;

package/library/packages/atoms/src/components/select/select.d.ts

@@ -86,6 +86,12 @@ export default class CxSelect extends CortexElement implements CortexFormControl
      * be an array. **For this reason, values must not contain spaces.**
      */
     value: string | string[];
+    /**
+     * The fallback option value used when the select value does not match
+     * any explicitly declared option.
+     * The original unmatched value is preserved for form submission.
+     */
+    fallbackOptionValue: string;
     /**
      * The default value of the form control. Primarily used for resetting the form control.
      */
@@ -321,6 +327,11 @@ export default class CxSelect extends CortexElement implements CortexFormControl
      * Gets an array of all visible <cx-option> elements
      */
     private getVisibleOptions;
+    /**
+     * Resolves selected options for the current value and applies fallback selection
+     * when unmatched values exist and `fallbackOptionValue` is configured.
+     */
+    private getOptionsForValue;
     /**
      * Sets the current option, which is the option the user is currently interacting with (e.g. via keyboard). Only one
      * option may be "current" at a time.

package/library/packages/atoms/src/components/table/table.d.ts

@@ -38,7 +38,7 @@ import { RowComponent, TabulatorFull as Tabulator } from './tabulator-tables';
  * @cssproperty [--header-font-size=var(--cx-font-size-small)] - The font size of the table header.
  * @cssproperty [--header-color=var(--cx-color-neutral-800)] - The color of the table header.
  * @cssproperty [--header-border-color=var(--cx-color-neutral-200)] - The color of the table header border.
- * @cssproperty [--header-height=auto] - The height of the table header.
+ * @cssproperty [--header-height=var(--cx-spacing-3x-large)] - The height of the table header.
  * @cssproperty [--header-horizontal-padding=var(--cx-spacing-2x-small)] - The horizontal padding of the table header.
  * @cssproperty [--cell-border-color=var(--cx-color-neutral-200)] - The color of the table cell border.
  * @cssproperty [--cell-horizontal-padding=var(--cx-spacing-2x-small)] - The horizontal padding of the table cell.
@@ -188,6 +188,12 @@ export default class CxTable extends CortexElement {
      * Fields to search in the table.
      */
     searchFields: string[];
+    /**
+     * Search keyword match mode. When `true`, any single keyword (split by space)
+     * matching is enough to include a row. When `false` (default), all keywords
+     * must match within a single field.
+     */
+    searchMatchAnyKeyword: boolean;
     /**
      * Whether to display a create new button
      */
@@ -209,7 +215,15 @@ export default class CxTable extends CortexElement {
      */
     canExportCustom: boolean;
     canSaveReport: boolean;
+    /**
+     * Endpoint URL for the saved search dropdown when `show-saved-search` is enabled.
+     * When set (non-empty), it takes precedence over `savedSearchItems` and the dropdown loads paged data via `fetch`.
+     */
     savedSearchURL: string;
+    /**
+     * Static saved searches for the toolbar dropdown when `show-saved-search` is enabled and `savedSearchURL` is empty.
+     * Each item uses `{ recordID, name }` (see `SavedSearchItem`).
+     */
     savedSearchItems: SavedSearchItem[];
     /**
      * The parameter name for the page size for the saved search dropdown
@@ -359,6 +373,10 @@ export default class CxTable extends CortexElement {
      * Enabling the groupUpdateOnCellEdit option will cause a row to be regrouped when the cell it is grouped by is edited.
      */
     groupUpdateOnCellEdit: boolean;
+    /**
+     * Load-more state keyed by the serialized group path returned by `group.getPathKey()`.
+     */
+    groupLoadMoreMeta: Options['groupLoadMoreMeta'];
     /**
      * If true, the table will be rendered as a tree.
      */
@@ -388,12 +406,6 @@ export default class CxTable extends CortexElement {
      * to be inserted in a different column you can pass the field name of the column to the dataTreeElementColumn setup option
      */
     dataTreeElementColumn: boolean | string | undefined;
-    /**
-     * The branch element is the right angled line running from parent to child to indicate its position in the tree.
-     * If false, the branch element will not be displayed.
-     * Alternatively, can provide a HTML string to use as the branch element.
-     */
-    dataTreeBranchElement: boolean | string | undefined;
     /**
      * The amount of pixels to indent the child rows.
      */
@@ -557,12 +569,16 @@ export default class CxTable extends CortexElement {
      * Whether to show the pagination buttons.
      */
     showPaginationButtons: boolean;
+    /**
+     * Whether to hide an editable input for the current page in the pagination counter.
+     */
+    hidePaginationInput: boolean;
     /**
      * Controls page size options. Either:
      * - true: Page size options will be multiples of the current page size.
      * - array: Page size options will be the numbers in the array. If 'true' is in the array, 'All' will be added to the list of options.
      */
-    paginationSizeSelector: true | Array<number | boolean> | undefined;
+    pageSizeOptions: true | Array<number | boolean> | undefined;
     /**
      * When using the addRow function on a paginated table, rows will be added relative to the current page (ie to the top or bottom of the current page), with overflowing rows being shifted onto the next page.
      *
@@ -644,6 +660,24 @@ export default class CxTable extends CortexElement {
      * Enables the overlay scrollbar plugin, which provides a custom scrollbar that does not take up any content space.
      */
     useOverlayScrollbar: boolean;
+    /**
+     * Controls the external loading state.
+     *
+     * When `true`, the loading spinner is shown regardless of whether the table's internal
+     * data load is in progress. The spinner only hides when both this property and the
+     * internal data load are `false`.
+     *
+     * Use this to manually show a loading indicator when fetching data outside the table
+     * (e.g. a parent component is preparing data before passing it in).
+     *
+     * To set loading imperatively, prefer `setLoading(value)` instead of assigning
+     * this property directly — both are equivalent but `setLoading()` makes intent clearer.
+     *
+     * To read whether the table is effectively loading (external or internal), use
+     * `isLoading()` instead of reading this property directly — `loading` only reflects
+     * the externally set state, not the internal data fetch.
+     */
+    loading: boolean;
     tabulatorInstance: Tabulator | null;
     /**
      * In case the table is re-initialized, we need to re-register the event listeners.
@@ -681,11 +715,18 @@ export default class CxTable extends CortexElement {
     handleGroupByChange(): void;
     handleGroupHeaderChange(): void;
     handleGroupValuesChange(): void;
+    handleGroupLoadMoreMetaChange(): void;
     handlePaginationSizeChange(): void;
+    handlePaginationChange(): Promise<void>;
+    private attachPaginatorToToolbar;
     handlePaginationInitialPageChange(): void;
+    handleLoadingChange(): void;
+    setLoading(value: boolean): void;
+    isLoading(): boolean;
     search(searchText: string): void;
     private handleSearch;
     handleSearchFieldsChange(): void;
+    handleSearchMatchAnyKeywordChange(): void;
     handleDropdownFiltersPropChange(): void;
     private handleTableExport;
     private handleDropdownFilterChange;

package/library/packages/atoms/src/components/table/tabulator-tables/core/Tabulator.d.ts

@@ -114,6 +114,7 @@ declare class Tabulator extends ModuleBinder implements ITabulator {
      */
     alert(contents: any, type?: string): void;
     clearAlert(): void;
+    isLoading(): boolean;
     /**
      * Extension Management
      */

package/library/packages/atoms/src/components/table/tabulator-tables/core/TabulatorFull.d.ts

@@ -21,6 +21,7 @@ declare class TabulatorFull extends Tabulator implements ITabulatorFull {
      * You can use the setGroupStartOpen function to change the default open state of groups. This function has one argument and takes the same values as passed to the groupStartOpen setup option.
      * Note: If you use the setGroupStartOpen or setGroupHeader before you have set any groups on the table, the table will not update until the setGroupBy function is called.
      */
+    setGroupLoadMoreMeta: (meta: Options['groupLoadMoreMeta']) => void;
     setGroupStartOpen: (values: Options['groupStartOpen']) => void;
     setGroupValues: (data: GroupValuesArg) => void;
     /**

package/library/packages/atoms/src/components/table/tabulator-tables/core/tools/DataLoader.d.ts

@@ -4,8 +4,9 @@ import { default as CoreFeature } from '../CoreFeature';
 export default class DataLoader extends CoreFeature implements IDataLoader {
     requestOrder: number;
     loading: boolean;
+    externalLoading: boolean;
     private debounceTimer;
-    private pendingPromise;
+    pendingPromise: Promise<void> | null;
     private pendingResolve;
     private pendingReject;
     private static readonly DEBOUNCE_DELAY;
@@ -28,6 +29,7 @@ export default class DataLoader extends CoreFeature implements IDataLoader {
     mapParams(params: Record<string, any>, map: Record<string, string>): Record<string, any>;
     objectInvert(obj: Record<string, string>): Record<string, string>;
     blockActiveLoad(): void;
+    setExternalLoading(value: boolean): void;
     alertLoader(): void;
     alertError(): void;
     clearAlert(): void;

package/library/packages/atoms/src/components/table/tabulator-tables/modules/Ajax/Ajax.d.ts

@@ -15,7 +15,7 @@ export default class Ajax extends Module {
     params: Record<string, unknown> | false;
     loaderPromise: LoaderPromise | false;
     contentTypeFormatters: Record<string, AjaxContentType>;
-    private fetchApi;
+    private readonly fetchApi;
     static defaultLoaderPromise: LoaderPromise;
     constructor(table: Tabulator);
     initialize(): void;

package/library/packages/atoms/src/components/table/tabulator-tables/modules/Edit/Edit.d.ts

@@ -43,6 +43,7 @@ export default class Edit extends Module {
     clearEditor(cancel: boolean): void;
     cancelEdit(): void;
     bindEditor(cell: Cell): void;
+    addListEditorTrigger(cell: Cell): void;
     focusCellNoEvent(cell: Cell, block?: boolean): void;
     editCell(cell: ICellComponent | null, forceEdit?: boolean): void;
     focusScrollAdjust(cell: Cell): void;

package/library/packages/atoms/src/components/table/tabulator-tables/modules/Edit/List.d.ts

@@ -8,6 +8,7 @@ import { default as Edit } from './Edit';
 interface ListItem {
     element?: CxOption;
     group?: boolean;
+    isFallbackOption?: boolean;
     itemParams?: any;
     label: string;
     level: number;
@@ -40,6 +41,7 @@ export default class List {
     currentItems: ListItem[];
     focusedItem: ListItem | null;
     input: CxSelect;
+    initialValue: any;
     initialValues: string[];
     /**
      * Whether the cell is a header cell, used for header filter of type list
@@ -52,7 +54,7 @@ export default class List {
         cancel: CancelCallback;
         success: SuccessCallback;
     };
-    private fetchApi;
+    private readonly fetchApi;
     constructor(editor: Edit, cell: Cell, onRendered: OnRenderedCallback, success: SuccessCallback, cancel: CancelCallback, editorParams: ListEditorParams);
     /**
      * cx-select only accepts string values without spaces
@@ -60,6 +62,7 @@ export default class List {
      */
     sanitizeValue(value: any): string;
     _initializeValue(): Promise<void>;
+    _getSanitizedInitialValues(initialValue: any): string[];
     _onRendered(): Promise<void>;
     clickStop(e: MouseEvent): void;
     /**
@@ -83,6 +86,23 @@ export default class List {
     _uniqueColumnValues(field?: string): string[];
     _emptyValueCheck(value: any): boolean;
     _parseList(inputValues: ListInputValues | Record<string, any>): ListItem[];
+    /**
+     * Ensures a fallback option exists when `fallbackOption.value` is configured.
+     * If the value is already declared in `values`, the existing item is tagged
+     * with `isFallbackOption` so visual customisation (divider, prefix) still applies.
+     * Otherwise a new auto-generated item is appended using the raw value as its label.
+     */
+    _appendFallbackOptionItem(data: ListItem[]): void;
+    /**
+     * Checks recursively whether grouped/flat list items already contain
+     * a given sanitized option value.
+     */
+    _hasListItemValue(items: ListItem[], sanitizedValue: string): boolean;
+    /**
+     * Finds and returns the first leaf item matching the given sanitized value,
+     * searching recursively through groups. Returns undefined when not found.
+     */
+    _findListItem(items: ListItem[], sanitizedValue: string): ListItem | undefined;
     _parseListItem(option: any, level: number): ListItem;
     _parseListGroup(option: any, level: number): ListItem;
     _sortOptions(options: ListItem[]): ListItem[];
@@ -102,6 +122,25 @@ export default class List {
     _cancel(): void;
     _chooseItem(item: ListItem, silent?: boolean): void;
     _getCommittedOutput(): any;
+    /**
+     * Resolves the selected values once so preserved fallback arrays are not
+     * inserted into a single selected-option slot.
+     */
+    _getCommittedMultipleOutput(options: HTMLElement[]): any[];
+    _getMappedOptionOutput(sanitized: string): any;
+    _getPreservedInputValueOutput(value: any): any;
+    _getPreservedFallbackMultipleOutput(sanitizedOptions: string[]): {
+        hasValue: false;
+    } | {
+        hasValue: true;
+        value: any[];
+    };
+    /**
+     * Checks for a preserved unmatched editor value when the selected option is
+     * the configured fallback option used for undeclared values.
+     */
+    _hasPreservedFallbackOptionOutput(sanitized: string): boolean;
+    _hasPreservedUnmatchedInputValue(inputValues: any[], sanitizedFallbackOptionValue: string): boolean;
     _resolveValue(commitItem?: ListItem): void;
 }
 export {};