@orangelogic/design-system 2.129.0 → 2.131.0

package/library/components/video.js

@@ -1,9 +1,9 @@
 import { _ as kd, a as Sa, b as Be, c as Je } from "../chunks/inheritsLoose.BuSn_CvZ.js";
 import { c as ps, a as Bn } from "../chunks/_commonjsHelpers.DQNKXVTB.js";
 import { r as Sb } from "../chunks/___vite-browser-external_commonjs-proxy.C2tf3HsQ.js";
-import { C as Cb } from "../chunks/image.CDrKFe1H.js";
+import { C as Cb } from "../chunks/image.BC_hwk-b.js";
 import Mb from "./resize-observer.js";
-import { r as Db, R as Pb, a as Rp, b as Lb } from "../chunks/resizable-component.styles.DpK0TTP5.js";
+import { r as Db, R as Pb, a as Rp, b as Lb } from "../chunks/resizable-component.styles.BVhOesNE.js";
 import { c as Rb } from "../chunks/component.styles.CRO4Odto.js";
 import { b as Ib } from "../chunks/browser.BHOCIF_A.js";
 import { c as Ob } from "../chunks/custom-element.L4WJXn1j.js";

package/library/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orangelogic/design-system",
   "type": "module",
-  "version": "2.129.0",
+  "version": "2.131.0",
   "license": "UNLICENSED",
   "types": "library/types.d.ts",
   "scripts": {

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

@@ -2,13 +2,14 @@ import { default as ResizableElement } from '../../../../base/src/resizable-elem
 import { ObjectFit } from '../../../../types/src/index.ts';
 import { ClickHandlerType } from '../../../../types/src/image';
 import { LocalizeController } from '../../../../utils/src/custom-element/i18n';
-import { TemplateResult } from 'lit';
+import { nothing, TemplateResult } from 'lit';
 import { Zoom } from 'medium-zoom';
 import { default as CxIcon } from '../icon/icon';
 import { default as CxPopup } from '../popup/popup';
 import { default as CxResizeObserver } from '../resize-observer/resize-observer';
 import { default as CxSkeleton } from '../skeleton/skeleton';
 import { default as CxSpace } from '../space/space';
+import { default as CxSpinner } from '../spinner/spinner';
 
 /**
  * @summary Images are wrappers for img elements with built-in lazy loading, skeleton, and fallback support.
@@ -16,7 +17,8 @@ import { default as CxSpace } from '../space/space';
  *
  * @csspart image - The `img` element.
  * @csspart skeleton - The skeleton element, will be shown while the image is loading and the `skeleton` property is set.
- * @csspart fallback - The fallback element, will be shown if the image fails to load and the `fallback` property is set.
+ * @csspart retry-spinner - The spinner overlay shown while a failed load is being retried (when `retry-on-error` is enabled).
+ * @csspart fallback - The fallback element, always shown when the image fails to load (after retries, when applicable).
  * @csspart base - The component’s outer wrapper.
  * @csspart fallback-icon - The icon rendered inside the fallback slot.
  *
@@ -27,6 +29,7 @@ import { default as CxSpace } from '../space/space';
  * @cssproperty --padding-bottom - The padding-bottom of the image (this will override the `--padding` property).
  * @cssproperty --border-radius - The border-radius of the image.
  * @cssproperty --border - The border of the image.
+ * @cssproperty [--fallback-icon-color=var(--cx-input-icon-color)] - The color of the icon shown when the image fails to load.
  *
  * @event cx-load - Emitted when the image has loaded.
  * @event cx-error - Emitted when the image has failed to load (after all retry attempts when `retry-on-error` is enabled).
@@ -34,7 +37,7 @@ import { default as CxSpace } from '../space/space';
  * @event cx-image-zoom-close - Emitted when the image zoom is closed.
  *
  * @slot skeleton - The skeleton element, will be shown while the image is loading and the `skeleton` property is set.
- * @slot fallback - The fallback element, will be shown if the image fails to load and the `fallback` property is set.
+ * @slot fallback - The fallback element, always shown when the image fails to load; override this slot to customize the broken-image UI.
  */
 export default class CxImage extends ResizableElement {
     static readonly styles: import('lit').CSSResult[];
@@ -44,17 +47,20 @@ export default class CxImage extends ResizableElement {
         'cx-resize-observer': typeof CxResizeObserver;
         'cx-skeleton': typeof CxSkeleton;
         'cx-space': typeof CxSpace;
+        'cx-spinner': typeof CxSpinner;
     };
     readonly localize: LocalizeController;
     imageElement?: HTMLImageElement;
     zoomImageElement: HTMLImageElement;
     highlighterElement: HTMLDivElement;
-    private _retryCount;
-    private _retryTimer;
+    private retryCount;
+    private retryTimer;
     isLoaded: boolean;
     isError: boolean;
+    /** True while a load has failed and a retry is scheduled or in-flight (retry-on-error only). */
+    isRetrying: boolean;
     /** Incremented on each retry attempt to force the img element to remount via keyed(). */
-    private _retryIndex;
+    private retryIndex;
     /**
      * The path to the image to load.
      */
@@ -76,7 +82,9 @@ export default class CxImage extends ResizableElement {
      */
     skeleton: boolean;
     /**
-     * Should show the fallback image when the image fails to load.
+     * @deprecated No longer required: the broken-image UI now always renders when the image
+     * fails to load, regardless of this property's value. Kept only for backward compatibility
+     * with existing markup that sets the `fallback` attribute.
      */
     fallback: boolean;
     /**
@@ -177,7 +185,7 @@ export default class CxImage extends ResizableElement {
     protected handleClickAction(event: MouseEvent): void;
     updated(changedProps: Map<string, unknown>): void;
     openZoom(): void;
-    protected renderContent(): TemplateResult;
+    protected renderContent(): TemplateResult | typeof nothing;
     render(): TemplateResult;
 }
 declare global {

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

@@ -6,6 +6,7 @@ import { default as CxIconButton } from '../icon-button/icon-button.ts';
 import { default as CxSelect } from '../select/select.ts';
 import { default as CxSpace } from '../space/space.ts';
 import { default as CxSpinner } from '../spinner/spinner.ts';
+import { default as CxTooltip } from '../tooltip/tooltip.ts';
 import { default as CortexElement } from '../../../../base/src/cortex-element.ts';
 import { RowComponent, TabulatorFull as Tabulator } from '../../../../hybrid/table-core/src/index.ts';
 import { PaginationCounter } from '../../../../types/src/pagination';
@@ -65,6 +66,7 @@ import { CxTableFooter, CxTableRowActions, CxTableToolbar } from './components';
  * E.g: `cx-table.rowMoved` will fire when `rowMoved` event is emitted.
  * @event {{ url: string, format: string, rowCount: number }} cx-table-data-load - Emitted when data is successfully loaded from dataUrl.
  * @event {{ url: string, error: unknown }} cx-table-data-load-error - Emitted when fetching or parsing data from dataUrl fails.
+ * @event {{ invalidCellCount: number, invalidCells: ICellComponent[] }} cx-table-validation-change - Emitted when the set of cells failing column `validator` rules changes (edit, load validation, or programmatic validate).
  */
 export default class CxTable extends CortexElement {
     #private;
@@ -82,6 +84,7 @@ export default class CxTable extends CortexElement {
         'cx-table-footer': typeof CxTableFooter;
         'cx-table-row-actions': typeof CxTableRowActions;
         'cx-table-toolbar': typeof CxTableToolbar;
+        'cx-tooltip': typeof CxTooltip;
     };
     private verticalOsInstance;
     private horizontalOsInstance;
@@ -94,6 +97,18 @@ export default class CxTable extends CortexElement {
     private readonly table;
     private readonly tableToolbar;
     private readonly tableFooter;
+    private readonly validationTooltip;
+    /** Cell element the shared validation tooltip is currently anchored to. */
+    private validationTooltipAnchor;
+    /** Pending delayed hide of the shared validation tooltip. */
+    private validationTooltipHideTimeout?;
+    /**
+     * In-flight hide transition of the shared validation tooltip. Calling
+     * show() while a hide animation is still running would race its tail
+     * (which deactivates the popup after the animation), leaving `open` true
+     * but the tooltip invisible — show waits for this to settle instead.
+     */
+    private validationTooltipHidePromise;
     movableRows: boolean;
     movableColumns: boolean;
     data: Options['data'];
@@ -175,6 +190,16 @@ export default class CxTable extends CortexElement {
      * If 'basic', virtual DOM is disabled.
      */
     renderVertical: Options['renderVertical'];
+    /**
+     * When true, the whole dataset is validated against the column `validator`
+     * definitions each time data is loaded or replaced.
+     */
+    validateOnLoad: Options['validateOnLoad'];
+    /**
+     * Row-count threshold above which table-wide validation passes are offloaded
+     * to a Web Worker to keep the main thread responsive.
+     */
+    validationWorkerThreshold: Options['validationWorkerThreshold'];
     /**
      * The columnDefaults option allows you to set default configs for all columns in the table.
      */
@@ -717,6 +742,24 @@ export default class CxTable extends CortexElement {
      * All logic that needs to run when the table is built should be placed here.
      */
     private readonly handleTableBuilt;
+    /** Re-emits table-core validation summaries as a typed Cortex event. */
+    private readonly handleValidationChanged;
+    /**
+     * One shared tooltip serves every invalid cell: on hover it is re-anchored
+     * to the hovered cell and filled with that cell's failure messages, instead
+     * of rendering a tooltip per cell.
+     */
+    private handleValidationMouseOver;
+    private showValidationTooltip;
+    private hideValidationTooltip;
+    /**
+     * cx-popup restarts its positioner with a debounce after an anchor change,
+     * which would leave a re-anchored (still open) tooltip hovering over the
+     * previous cell while already showing the new cell's content — force an
+     * immediate reposition once the popup has adopted the new anchor.
+     */
+    private repositionValidationTooltipNow;
+    private handleValidationMouseOut;
     disconnectedCallback(): void;
     private initVerticalScrollbar;
     private initHorizontalScrollbar;

package/library/packages/base/src/highlightable-element.d.ts

@@ -60,11 +60,12 @@ export default class HighlightableElement extends CortexElement {
      */
     isHovering: boolean;
     get easeCSSVariable(): string;
-    getHighlighterClass(): {
+    getHighlighterClass(isError?: boolean): {
         [x: string]: boolean;
         highlighter: boolean;
         'highlighter--background': boolean;
         'highlighter--border': boolean;
+        'highlighter--centered': boolean;
         'highlighter--color-overlay': boolean;
         'highlighter--drop-shadow': boolean;
         'highlighter--opacity': boolean;

package/library/packages/events/src/cx-table-validation-change.d.ts

@@ -0,0 +1,8 @@
+import { ValidationSummary } from '../../types/src/table';
+
+export type CxTableValidationChangeEvent = CustomEvent<ValidationSummary>;
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-table-validation-change': CxTableValidationChangeEvent;
+    }
+}

package/library/packages/events/src/events.d.ts

@@ -11,6 +11,7 @@ export * from './cx-after-expand';
 export * from './cx-after-hide';
 export * from './cx-after-show';
 export * from './cx-asset-data-display-slot-change';
+export * from './cx-asset-format-picker-select';
 export * from './cx-asset-picker-delete';
 export * from './cx-asset-picker-select';
 export * from './cx-asset-request-status';
@@ -63,7 +64,6 @@ export * from './cx-dot-status-click';
 export * from './cx-download-format-picker-delete';
 export * from './cx-download-format-picker-select';
 export * from './cx-download-format-request-status';
-export * from './cx-asset-format-picker-select';
 export * from './cx-drag-end';
 export * from './cx-drag-start';
 export * from './cx-e-chart-drill-down';
@@ -79,8 +79,8 @@ export * from './cx-file-on-demand-unpin';
 export * from './cx-find-and-replace';
 export * from './cx-finish';
 export * from './cx-focus';
-export * from './cx-folder-select-search-term-change';
 export * from './cx-folder-select-children-loaded';
+export * from './cx-folder-select-search-term-change';
 export * from './cx-gallery-chunk-request';
 export * from './cx-gallery-config-save';
 export * from './cx-gallery-item-click';
@@ -162,7 +162,6 @@ export * from './cx-save';
 export * from './cx-save-settings';
 export * from './cx-sb-button-click';
 export * from './cx-sb-dam-view-config-change';
-export * from './cx-video-thumbnail-resolved';
 export * from './cx-search';
 export * from './cx-select';
 export * from './cx-selected-change';
@@ -170,8 +169,8 @@ export * from './cx-selection-change';
 export * from './cx-shadow-input-group-change';
 export * from './cx-share-option-list-item-selected';
 export * from './cx-show';
-export * from './cx-special-characters-insert';
 export * from './cx-slide-change';
+export * from './cx-special-characters-insert';
 export * from './cx-start';
 export * from './cx-swatch-add';
 export * from './cx-tab-hide';
@@ -183,9 +182,10 @@ export * from './cx-table-export';
 export * from './cx-table-row-action-click';
 export * from './cx-table-save-search-select';
 export * from './cx-table-switch-change';
+export * from './cx-table-validation-change';
 export * from './cx-time-based-change';
-export * from './cx-timeline-data-resolved';
 export * from './cx-time-update';
+export * from './cx-timeline-data-resolved';
 export * from './cx-tiptap-code-block-doc-request';
 export * from './cx-tiptap-image-doc-request';
 export * from './cx-tiptap-image-host-feedback';
@@ -193,11 +193,12 @@ export * from './cx-tiptap-video-doc-request';
 export * from './cx-tiptap-video-host-feedback';
 export * from './cx-typeface-change';
 export * from './cx-typeface-download';
-export * from './cx-undo';
 export * from './cx-unauthorized';
+export * from './cx-undo';
 export * from './cx-unmark-favorite';
 export * from './cx-video-click';
 export * from './cx-video-editor-track-canvas-ready';
 export * from './cx-video-editor-track-click';
 export * from './cx-video-editor-transition-click';
+export * from './cx-video-thumbnail-resolved';
 export * from './cx-view-logs';

package/library/packages/hybrid/table-core/src/tabulator-tables/index.d.ts

@@ -13,3 +13,4 @@ export { default as Row } from './core/row/Row';
 export { default as Cell } from './core/cell/Cell';
 export { default as Module } from './core/Module';
 export { default as Renderer } from './core/rendering/Renderer';
+export { VALIDATION_MESSAGE_ATTRIBUTE } from './modules/Validate/Validate';

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Validate/Validate.d.ts

@@ -1,36 +1,104 @@
+import { CellValidationFailure, ICellComponent, StandardValidatorType, ValidationSummary, Validator } from '../../../../../../types/src/table';
 import { default as Cell } from '../../core/cell/Cell';
 import { default as Column } from '../../core/column/Column';
 import { default as Module } from '../../core/Module';
 import { default as Row } from '../../core/row/Row';
 import { default as Tabulator } from '../../core/Tabulator';
 
-type ValidatorFunction = (cell: any, value: any, parameters: any) => boolean;
+/**
+ * Attribute carrying the joined failure messages of an invalid cell.
+ * Consumers (e.g. cx-table) read it to display a tooltip — a data attribute
+ * instead of `title` so the native browser tooltip does not compete with it.
+ */
+export declare const VALIDATION_MESSAGE_ATTRIBUTE = "data-validation-message";
+type ValidatorFunction = (cell: ICellComponent, value: unknown, parameters?: unknown) => boolean;
 type ValidatorConfig = {
     func: ValidatorFunction;
-    params: any;
+    message?: string;
+    params: unknown;
     type: string;
 };
 export default class Validate extends Module {
     static readonly moduleName = "validate";
     static readonly validators: Record<string, ValidatorFunction>;
-    invalidCells: Cell[];
+    /**
+     * Validation results keyed by row → column. Virtual renderers delete and
+     * recreate Cell objects as rows scroll in and out of the render window,
+     * while Row and Column objects persist — so keying by row/column keeps
+     * invalid state (and counts) stable across scrolling. Cells without a
+     * row/column (detached mocks) key by the cell itself.
+     */
+    private readonly invalidState;
+    get invalidCells(): Cell[];
+    set invalidCells(cells: Cell[]);
+    /**
+     * Bumped whenever data is replaced or a new table-wide validation starts, so
+     * results of superseded async validations are discarded instead of applied.
+     */
+    private validationGeneration;
+    /** Batch operations set this to emit one validationChanged instead of one per cell. */
+    private suppressValidationChanged;
     constructor(table: Tabulator);
     initialize(): void;
-    editValidate(cell: Cell, value: any, _previousValue: any): boolean | any;
+    editValidate(cell: Cell, value: unknown, _previousValue: unknown): boolean | CellValidationFailure[];
     editorClear(cell: Cell, cancelled: boolean): void;
     editedClear(cell: Cell): void;
+    /**
+     * A deleted cell must NOT drop its validation state: virtual renderers
+     * delete and recreate Cell objects as rows scroll in and out of the render
+     * window, and the row-keyed record is restored by layoutCell when the cell
+     * is rebuilt. True removals are handled by rowDeleted/columnDeleted.
+     */
+    cellDeleted(cell: Cell): void;
+    rowDeleted(row: Row): void;
+    columnDeleted(column: Column): void;
+    /**
+     * Cells are recycled by the virtual renderers, so persisted validation state
+     * must be restored onto the freshly built cell whenever its DOM is (re)built.
+     */
+    layoutCell(cell: Cell): void;
+    dataProcessed(): void;
     cellIsValid(cell: Cell): boolean;
-    cellValidate(cell: Cell): boolean | any;
-    columnValidate(column: Column): any[] | boolean;
-    rowValidate(row: Row): any[] | boolean;
-    userClearCellValidation(cells?: any): void;
-    userValidate(_cells?: any): any[] | boolean;
+    cellValidate(cell: Cell): CellValidationFailure[] | boolean;
+    columnValidate(column: Column): ICellComponent[] | boolean;
+    rowValidate(row: Row): ICellComponent[] | boolean;
+    userClearCellValidation(cells?: ICellComponent | ICellComponent[]): void;
+    userValidate(_cells?: unknown): ICellComponent[] | boolean;
+    /**
+     * Validates the whole dataset without blocking the main thread on large
+     * tables: below `validationWorkerThreshold` rows it runs synchronously,
+     * above it JSON rules are offloaded to a shared Web Worker (columns with
+     * function validators stay on the main thread, processed in yielding
+     * chunks). Superseded runs (new validation or data reload) are discarded.
+     */
+    validateAsync(): Promise<ValidationSummary>;
+    getValidationSummary(): ValidationSummary;
     initializeColumnCheck(column: Column): void;
     initializeColumn(column: Column): void;
-    _extractValidator(value: any): ValidatorConfig | false;
-    _buildValidator(type: string | ValidatorFunction, params?: any): ValidatorConfig | false;
-    validate(validators: ValidatorConfig[] | false | undefined, cell: Cell, value: any): any[] | boolean;
-    getInvalidCells(): any[];
+    _extractValidator(value: StandardValidatorType | Validator | ValidatorFunction | string): ValidatorConfig | false;
+    _buildValidator(type: string | ValidatorFunction, params?: unknown, message?: string): ValidatorConfig | false;
+    validate(validators: ValidatorConfig[] | false | undefined, cell: Cell, value: unknown): CellValidationFailure[] | boolean;
+    getInvalidCells(): ICellComponent[];
     clearValidation(cell: Cell): void;
+    private rowKeyOf;
+    private columnKeyOf;
+    private getInvalidRecord;
+    private registerInvalidCell;
+    private unregisterInvalidCell;
+    private countInvalidCells;
+    private getValidatedColumns;
+    private validateColumnsOnWorker;
+    private applyWorkerResults;
+    private applyBatchFailures;
+    /**
+     * Columns with function validators cannot run in the worker; validate them
+     * on the main thread in chunks, yielding between chunks to keep the UI
+     * responsive.
+     */
+    private validateColumnsOnMainThread;
+    private applyCellInvalidState;
+    private clearCellInvalidState;
+    private runSuppressed;
+    private dispatchValidationChanged;
 }
 export {};

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Validate/defaults/rule-functions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure validation rule functions shared by the main-thread Validate module and
+ * the validation Web Worker.
+ *
+ * Every function is side-effect free and depends only on its arguments — no
+ * cell, DOM, or table access — so the same code can run inside a worker where
+ * only JSON-serializable data is available. Cell/table-dependent inputs (e.g.
+ * the column values needed by `unique`) are passed in through `RuleContext`.
+ *
+ * Semantics preserved from the original validators: an empty value
+ * (`''`, `null`, `undefined`) passes every rule except `required`.
+ */
+/** Extra inputs a rule may need that are not part of the cell value itself. */
+export interface RuleContext {
+    /** All values of the cell's column (used by `unique`), excluding the cell's own row. */
+    columnValues?: unknown[];
+}
+export type RuleFunction = (value: unknown, parameters?: any, context?: RuleContext) => boolean;
+declare const ruleFunctions: Record<string, RuleFunction>;
+export default ruleFunctions;

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Validate/defaults/validators.d.ts

@@ -1,18 +1,9 @@
-declare const _default: {
-    alphanumeric: (_cell: any, value: any, _parameters: any) => boolean;
-    ends: (_cell: any, value: any, parameters: any) => boolean;
-    float: (_cell: any, value: any, _parameters: any) => boolean;
-    in: (_cell: any, value: any, parameters: any) => boolean;
-    integer: (_cell: any, value: any, _parameters: any) => boolean;
-    max: (_cell: any, value: any, parameters: any) => boolean;
-    maxLength: (_cell: any, value: any, parameters: any) => boolean;
-    min: (_cell: any, value: any, parameters: any) => boolean;
-    minLength: (_cell: any, value: any, parameters: any) => boolean;
-    numeric: (_cell: any, value: any, _parameters: any) => boolean;
-    regex: (_cell: any, value: any, parameters: any) => boolean;
-    required: (_cell: any, value: any, _parameters: any) => boolean;
-    starts: (_cell: any, value: any, parameters: any) => boolean;
-    string: (_cell: any, value: any, _parameters: any) => boolean;
-    unique: (this: any, cell: any, value: any, _parameters: any) => boolean;
-};
-export default _default;
+import { ICellComponent } from '../../../../../../../types/src/table';
+
+/**
+ * Cell-facing validator signature expected by the Validate module and custom
+ * consumer validators. Mirrors `ValidatorFunction` in `Validate.ts`.
+ */
+export type CellValidator = (cell: ICellComponent, value: unknown, parameters?: unknown) => boolean;
+declare const validators: Record<string, CellValidator>;
+export default validators;

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Validate/validation-worker-client.d.ts

@@ -0,0 +1,13 @@
+import { ValidationWorkerFailureEntry, ValidationWorkerField } from './validation.worker';
+
+export type { ValidationWorkerFailureEntry, ValidationWorkerField };
+/**
+ * Validates pre-extracted column values against JSON rules on the shared
+ * validation worker.
+ *
+ * Resolves with every failure entry once the worker finishes; `onChunk` fires
+ * per processed row chunk for progressive application. Rejects if the worker
+ * crashes or cannot start — callers should fall back to synchronous
+ * validation.
+ */
+export declare function validateBatch(fields: ValidationWorkerField[], onChunk?: (results: ValidationWorkerFailureEntry[]) => void): Promise<ValidationWorkerFailureEntry[]>;

package/library/packages/molecules/src/asset-picker/asset-picker.d.ts

@@ -63,8 +63,9 @@ export default class CxAssetPicker extends CortexElement {
      */
     onRequestAsset: ((type: AssetTypeString, multiple?: boolean, accepts?: string[], restrictType?: AssetTypeString) => Promise<Asset | Record<string, Asset>>) | undefined;
     /**
-     * An optional record ID used to fetch a clean preview image, bypassing any
-     * stored URL that may have transformations applied.
+     * An optional record ID (or space-separated list of record IDs, for `multiple`
+     * pickers) used to fetch a clean preview image and title, bypassing any stored
+     * URL/name that may be stale or have transformations applied.
      */
     recordId: string;
     /** When true, uses the Site Builder search endpoint for asset fetching. */

package/library/packages/organisms/src/bento-grid/bento-grid.d.ts

@@ -224,7 +224,7 @@ export default class CxBentoGrid extends CortexElement {
     private getItemSize;
     /**
      * Determines the number of columns for the grid based on the current
-     * container width and breakpoints. Also builds filledData when filler is active.
+     * window width and breakpoints. Also builds filledData when filler is active.
      */
     private setupGrid;
     /**

package/library/packages/organisms/src/content-builder/components/config-form/config-form-controller.d.ts

@@ -10,6 +10,12 @@ export declare class ConfigFormController implements ReactiveController {
     private readonly pendingGalleryPickerSaves;
     constructor(host: ReactiveControllerHost & CxConfigForm);
     hostConnected(): void;
+    /**
+     * `TRX` proxies preserve the asset's original extension. When that extension is not a
+     * browser-displayable image format, fall back to the `TR1` transformation proxy, which is
+     * always transcoded to a raster format. Mirrors the same fallback in `FetchImageController`
+     * (used by the gallery/timeline blocks) and `cx-asset-transformation-dialog`.
+     */
     private resolveAssetFormatSrc;
     private handleStyleChange;
     private handleAttributeChange;

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

@@ -928,6 +928,11 @@ export interface ITabulatorFull extends ITabulator {
     createFilterFieldFunction: IFilter['createFilterFieldFunction'];
     clearFilter: IFilter['clearFilter'];
     setSort: (sortList: string | Sorter[], dir?: SortDirection) => void;
+    validate: () => true | ICellComponent[];
+    validateAsync: () => Promise<ValidationSummary>;
+    getValidationSummary: () => ValidationSummary;
+    getInvalidCells: () => ICellComponent[];
+    clearCellValidation: (cells?: ICellComponent | ICellComponent[]) => void;
 }
 /**
  * Table type
@@ -1769,6 +1774,19 @@ export interface OptionsGeneral {
      * manual - no validation is automatically performed on edit, but it can be triggered by calling the validate function on the table or any Component Object
      */
     validationMode?: 'blocking' | 'highlight' | 'manual';
+    /**
+     * When true, the whole dataset is validated automatically each time data is
+     * loaded or replaced (`data-processed`). Defaults to false for backward
+     * compatibility.
+     */
+    validateOnLoad?: boolean;
+    /**
+     * Row-count threshold above which table-wide validation passes
+     * (`validateAsync` / `validateOnLoad`) are offloaded to a Web Worker instead
+     * of running synchronously on the main thread. Set to `false` to always
+     * validate synchronously. Defaults to 2000.
+     */
+    validationWorkerThreshold?: number | false;
     textDirection?: TextDirection;
     /**
      * Sometimes it can be useful to add a visual header to the start of a row.
@@ -2607,10 +2625,45 @@ export type JSONRecord = Record<string, string | number | boolean>;
  *     {title:"Example", field:"example", validator:"regex:\\.com$"} \\allow strings that end in '.com'
  * ```
  */
-export type StandardValidatorType = 'required' | 'unique' | 'integer' | 'float' | 'numeric' | 'string' | 'alphanumeric';
+export type StandardValidatorType = 'required' | 'unique' | 'integer' | 'float' | 'numeric' | 'string' | 'alphanumeric' | 'boolean' | 'date' | 'in' | 'regex';
+/** Range constraints accepted by the numeric-type validators (`numeric`, `integer`, `float`). */
+export interface NumericValidatorParameters {
+    min?: number;
+    max?: number;
+}
+/** Length constraints accepted by the `string` validator. */
+export interface StringValidatorParameters {
+    minLength?: number;
+    maxLength?: number;
+}
+/**
+ * Range constraints accepted by the `date` validator. `starts` / `ends` are
+ * inclusive bounds as ISO date strings (or anything `Date.parse` understands).
+ */
+export interface DateValidatorParameters {
+    starts?: string;
+    ends?: string;
+}
 export interface Validator {
     type: StandardValidatorType | ((cell: ICellComponent, value: any, parameters?: any) => boolean);
     parameters?: any;
+    /**
+     * Optional human-readable error message attached to validation failures for
+     * this rule. Propagated to cell validation state, the cell `title` tooltip,
+     * and validation events. JSON-serializable.
+     */
+    message?: string;
+}
+/** A single failed validation rule on a cell. */
+export interface CellValidationFailure {
+    type: string;
+    parameters?: any;
+    message?: string;
+}
+/** Aggregate result of a table-wide validation pass. */
+export interface ValidationSummary {
+    invalidCellCount: number;
+    invalidCells: ICellComponent[];
 }
 export type ColumnSorterParamLookupFunction = (column: IColumnComponent, dir: SortDirection) => Record<string, unknown>;
 export type ColumnLookup = IColumn | IColumnComponent | ColumnDefinition | HTMLElement | string;
@@ -2815,6 +2868,7 @@ export interface RangeComponent {
 }
 export interface EventCallBackMethods {
     validationFailed: (cell: ICellComponent, value: any, validators: Validator[]) => void;
+    validationChanged: (summary: ValidationSummary) => void;
     scrollHorizontal: (left: number, leftDir: boolean) => void;
     scrollVertical: (top: number, topDir: boolean) => void;
     rowAdded: (row: IRowComponent) => void;