@orangelogic/design-system 2.77.0 → 2.78.0-ci.3

package/library/package.json

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

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

@@ -13,7 +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. 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`).
+ * @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
  *
@@ -95,6 +95,7 @@ export default class CxPagination extends CortexElement {
     get pageEnd(): number;
     get prevDisabled(): boolean;
     get nextDisabled(): boolean;
+    private get hasMultiplePages();
     private updatePageCount;
     private handlePageSizeSelectChange;
     private handleFirst;

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/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

@@ -40,6 +40,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 +53,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 +61,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 +85,16 @@ export default class List {
     _uniqueColumnValues(field?: string): string[];
     _emptyValueCheck(value: any): boolean;
     _parseList(inputValues: ListInputValues | Record<string, any>): ListItem[];
+    /**
+     * Appends a fallback option when `fallbackOptionValue` is configured
+     * and not explicitly declared in the list values.
+     */
+    _appendFallbackOptionItem(data: ListItem[]): void;
+    /**
+     * Checks recursively whether grouped/flat list items already contain
+     * a given sanitized option value.
+     */
+    _hasListItemValue(items: ListItem[], sanitizedValue: string): boolean;
     _parseListItem(option: any, level: number): ListItem;
     _parseListGroup(option: any, level: number): ListItem;
     _sortOptions(options: ListItem[]): ListItem[];
@@ -102,6 +114,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 {};

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

@@ -1,4 +1,5 @@
 import { CortexFormControl, default as CortexElement } from '../../../../base/src/cortex-element.ts';
+import { TextareaRows } from '../../../../types/src/textarea';
 import { CSSResultGroup } from 'lit';
 
 /**
@@ -20,6 +21,8 @@ import { CSSResultGroup } from 'lit';
  * @csspart base - The component's base wrapper.
  * @csspart textarea - The internal `<textarea>` control.
  * @csspart character-count - The container that wraps the character count.
+ *
+ * @typedef {number | 'max'} TextareaRows - Use a number for a fixed row count. Use `'max'` to fill the parent container height (parent must have a definite height). With `'max'`, `resize="vertical"` and `resize="none"` work; `resize="auto"` does not (it is disabled).
  */
 export default class CxTextarea extends CortexElement implements CortexFormControl {
     static styles: CSSResultGroup;
@@ -27,6 +30,7 @@ export default class CxTextarea extends CortexElement implements CortexFormContr
     private readonly hasSlotController;
     private resizeObserver;
     input: HTMLTextAreaElement;
+    private formControlRoot;
     private hasFocus;
     title: string;
     /** The name of the textarea, submitted as a name/value pair with form data. */
@@ -43,9 +47,17 @@ export default class CxTextarea extends CortexElement implements CortexFormContr
     helpText: string;
     /** Placeholder text to show as a hint when the input is empty. */
     placeholder: string;
-    /** The number of rows to display by default. */
-    rows: number;
-    /** Controls how the textarea can be resized. */
+    /**
+     * The number of rows to display by default.
+     * Set to `"max"` (or `TextareaRows.Max`) to make the textarea fill its parent container height.
+     * The parent element must have a definite height (e.g. via flex, grid, or an explicit `height`) for `"max"` to take effect.
+     * With `"max"`, `resize="vertical"` (default) and `resize="none"` are supported; `resize="auto"` is not (fill height and auto-grow conflict, so auto resize is disabled).
+     */
+    rows: number | TextareaRows;
+    /**
+     * Controls how the textarea can be resized.
+     * When `rows` is `"max"`, `auto` is ignored; use `vertical` or `none`.
+     */
     resize: 'none' | 'vertical' | 'auto';
     /** Disables the textarea. */
     disabled: boolean;
@@ -87,13 +99,16 @@ export default class CxTextarea extends CortexElement implements CortexFormContr
     inputMode: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
     /** The default value of the form control. Primarily used for resetting the form control. */
     defaultValue: string;
+    /** Tracks the px height applied by fill-mode so we can distinguish a host resize (recalculate) from a user drag (preserve). */
+    private _fillHeightPx;
     /** Gets the validity state object */
     get validity(): ValidityState;
     /** Gets the validation message */
     get validationMessage(): string;
-    connectedCallback(): void;
+    connectedUpdatedCallback(): void;
     runFirstUpdated(): void;
     disconnectedCallback(): void;
+    private updateResizeObserver;
     private handleBlur;
     private handleChange;
     private handleFocus;

package/library/packages/organisms/src/carousel/carousel.d.ts

@@ -205,6 +205,7 @@ export default class CxCarousel extends CortexElement {
      * The timeout for the fade transition. (Only for programmatically scroll by gsap)
      */
     fadeTimeout: ReturnType<typeof setTimeout> | null;
+    private fadeTransitionToken;
     /**
      * The range of the carousel. Presenting current visible slides index range.
      */
@@ -339,6 +340,7 @@ export default class CxCarousel extends CortexElement {
      */
     goToSlide(index: number, behavior?: ScrollBehavior): void;
     private removeCloneContainer;
+    private finishFadeTransition;
     /**
      * Scrolls to the given slide, allowing an optional duration (in ms) for the scroll animation.
      * If duration is provided and behavior is 'smooth', a custom smooth scroll is performed.

package/library/packages/types/src/table.d.ts

@@ -2441,6 +2441,8 @@ export interface ListEditorParams extends SharedEditorParams, SharedSelectAutoCo
     valuesURL?: string;
     valuesLookup?: ListEditorValuesLookup;
     valuesLookupField?: string;
+    fallbackOptionLabel?: string;
+    fallbackOptionValue?: string | number | boolean;
     clearable?: boolean;
     getItemLabel?: (label: string, value: string, item: any, element: HTMLElement) => string;
     sort?: SortDirection;

package/library/packages/types/src/textarea.d.ts

@@ -0,0 +1,4 @@
+/** Special value for the `rows` property that makes the textarea fill its parent container height. */
+export declare enum TextareaRows {
+    Max = "max"
+}

package/library/packages/utils/src/url/url.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Returns the relative portion of a URL when it shares the same origin as the
+ * current page (or the provided `origin`). Returns the original value unchanged
+ * when the URL is cross-origin, already relative, or falsy.
+ *
+ * @param url - The URL to normalise.
+ * @param origin - Origin to compare against (defaults to `window.location.origin`).
+ */
+export declare function toRelativeUrl(url: string | null | undefined, origin?: string): string | undefined;
 export declare const appendProtocol: (inputUrl: string, defaultProtocol?: string, ignoreRelativeUrl?: boolean) => string;
 export declare const isValidUrl: (urlString: string) => boolean;
 export declare const RELATIVE_URL_REGEX: string;