@orangelogic/design-system 2.132.0 → 2.134.0

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Format/defaults/formatters/date.d.ts

@@ -0,0 +1,12 @@
+import { DateFormatterParams } from '../../../../../../../../types/src/table';
+import { default as CellComponent } from '../../../../core/cell/CellComponent';
+import { default as Format } from '../../Format';
+
+/**
+ * Formats the value of a cell as a date/time using cx-format-date.
+ * The cell value is the single source of truth for the date.
+ *
+ * When noDatetimeSeparator is true, cx-format-date removes the locale connector
+ * (e.g. " at " in en-US) that appears between date and time parts.
+ */
+export default function date(this: Format, cell: CellComponent, formatterParams: DateFormatterParams): HTMLElement | string;

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/Format/defaults/formatters/diff.d.ts

@@ -1,5 +1,6 @@
+import { default as CxLineClamp } from '../../../../../../../../atoms/src/components/line-clamp/line-clamp.ts';
 import { DiffFormatterParams } from '../../../../../../../../types/src/table';
 import { default as CellComponent } from '../../../../core/cell/CellComponent';
 import { default as Format } from '../../Format';
 
-export default function diff(this: Format, cell: CellComponent, formatterParams: DiffFormatterParams): HTMLElement | string;
+export default function diff(this: Format, cell: CellComponent, formatterParams: DiffFormatterParams): CxLineClamp;

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

@@ -1,9 +1,11 @@
 import { default as adaptable } from './formatters/adaptable';
 import { default as array } from './formatters/array';
+import { default as avatar } from './formatters/avatar';
 import { default as buttonCross } from './formatters/buttonCross';
 import { default as buttonTick } from './formatters/buttonTick';
 import { default as color } from './formatters/color';
 import { default as composite } from './formatters/composite';
+import { default as date } from './formatters/date';
 import { default as datetime } from './formatters/datetime';
 import { default as datetimediff } from './formatters/datetimediff';
 import { default as diff } from './formatters/diff';
@@ -32,10 +34,12 @@ import { default as typography } from './formatters/typography';
 declare const defaultFormatters: {
     adaptable: typeof adaptable;
     array: typeof array;
+    avatar: typeof avatar;
     buttonCross: typeof buttonCross;
     buttonTick: typeof buttonTick;
     color: typeof color;
     composite: typeof composite;
+    date: typeof date;
     datetime: typeof datetime;
     datetimediff: typeof datetimediff;
     diff: typeof diff;

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

@@ -59,6 +59,7 @@ export default class Group {
     getGroupLoadMoreEventPayload(): GroupLoadMoreEventPayload;
     generateLoadMoreRow(): Row | false;
     private applyGroupIndent;
+    private getGroupIndentTargetCell;
     getHeadersAndRows(): Array<Group | Row>;
     getData(visible?: boolean, transform?: string): any[];
     getRowCount(): number;

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

@@ -30,6 +30,13 @@ export default class GroupRows extends Module {
     _blockRedrawing(): void;
     _restore_redrawing(): void;
     configureGroupSetup(): void;
+    /**
+     * Render the default group header by running the grouped column's formatter,
+     * reusing the same mock-cell pattern as `Format.formatHeader`. Returns a
+     * wrapper element, or `null` when the formatter cannot/should not run so the
+     * caller falls back to the plain-text header.
+     */
+    buildFormattedGroupHeader(value: any, data: any[], component: GroupComponent): HTMLElement | null;
     rowSample(rows: Row[], prevValue: Row[]): Row[];
     virtualRenderFill(): Row[] | void;
     rowAddingIndex(row: Row, index: Row | false, top: boolean): Row | false;

package/library/packages/hybrid/table-core/src/tabulator-tables/modules/SelectRow/extensions/formatters/rowSelection.d.ts

@@ -2,4 +2,4 @@ import { RowSelectionParams } from '../../../../../../../../types/src/table';
 import { default as CellComponent } from '../../../../core/cell/CellComponent';
 import { default as SelectRow } from '../../SelectRow';
 
-export default function (this: SelectRow, cell: CellComponent, formatterParams: RowSelectionParams): string | HTMLElement;
+export default function (this: SelectRow, cell: CellComponent, formatterParams: RowSelectionParams, onRendered: (callback: () => void) => void): string | HTMLElement;

package/library/packages/molecules/src/faceted-filter/faceted-filter.d.ts

@@ -18,6 +18,8 @@ import { CSSResultGroup } from 'lit';
  *
  * @event {{ selection: SelectedFacets }} cx-faceted-filter-change - Fired whenever
  * the user changes a selection, removes a tag, or clears all filters.
+ *
+ * @cssproperty [--panel-max-height=600px] - The maximum height of the dropdown panel and its content.
  */
 export default class CxFacetedFilter extends CortexElement {
     static readonly styles: CSSResultGroup;

package/library/packages/types/src/faceted-filter.d.ts

@@ -90,3 +90,14 @@ export type FacetRenderContext = {
     /** Selected checkbox values for this facet (`internalSelection[field]`). */
     selectionValues: string[];
 };
+/** The author-facing control token used in `cx-table`'s `facet-config` attribute. */
+export declare enum FacetConfigTableType {
+    Checkbox = "checkbox",
+    DatePicker = "datePicker",
+    DateRangePicker = "dateRangePicker"
+}
+/** The author-facing option token used after a `facet-config` type. */
+export declare enum FacetConfigTableOption {
+    ShowPreset = "showPreset",
+    ShowTime = "showTime"
+}

package/library/packages/types/src/format-date.d.ts

@@ -0,0 +1,12 @@
+export type FormatDateWeekday = 'long' | 'short' | 'narrow';
+export type FormatDateEra = 'long' | 'short' | 'narrow';
+export type FormatDateYear = 'numeric' | '2-digit';
+export type FormatDateMonth = 'numeric' | '2-digit' | 'narrow' | 'short' | 'long';
+export type FormatDateDay = 'numeric' | '2-digit';
+export type FormatDateHour = 'numeric' | '2-digit';
+export type FormatDateMinute = 'numeric' | '2-digit';
+export type FormatDateSecond = 'numeric' | '2-digit';
+export type FormatDateTimeZoneName = 'short' | 'long';
+export type FormatDateTimeZoneHour = 'auto' | '12' | '24';
+export declare const DATE_PART_TYPES: Set<string>;
+export declare const TIME_PART_TYPES: Set<string>;

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

@@ -1,4 +1,5 @@
 import { ButtonVariant } from './button';
+import { FormatDateDay, FormatDateEra, FormatDateHour, FormatDateMinute, FormatDateMonth, FormatDateSecond, FormatDateTimeZoneHour, FormatDateTimeZoneName, FormatDateWeekday, FormatDateYear } from './format-date';
 import { FormatNumberCurrencyDisplay, FormatNumberType } from './format-number';
 import { PaginationCounter } from './pagination';
 import { SpaceJustifyContentProp, SpaceWrapProp, SpacingProp } from './space';
@@ -915,7 +916,7 @@ export interface IModule extends ICoreFeature {
 }
 export interface ITabulatorFull extends ITabulator {
     setSheetData: (lookup: string | SpreadsheetComponent, data: unknown[][]) => void;
-    setGroupBy: (groups: GroupArg) => void;
+    setGroupBy: (groups: GroupArg | false) => void;
     setGroupHeader: (values: Options['groupHeader']) => void;
     setGroupLoadMoreMeta: (meta: GroupLoadMoreMeta | undefined) => void;
     setGroupStartOpen: (values: Options['groupStartOpen']) => void;
@@ -1323,6 +1324,13 @@ export interface OptionsRowGrouping {
     groupHeader?: ((value: any, count: number, data: any, group: IGroupComponent) => string) | Array<(value: any, count: number, data: any, group: IGroupComponent) => string>;
     /** When true, displays the item count in the group header. */
     groupHeaderCount?: boolean;
+    /**
+     * When true, the default group header reuses the grouped column's `formatter`
+     * (e.g. composite avatar + name) to render the header value instead of plain
+     * text. Defaults to false so existing grouped tables keep plain-text headers.
+     * Ignored when a custom `groupHeader` function is supplied.
+     */
+    groupHeaderUseFormatter?: boolean;
     /** Indentation in pixels applied per group level. Defaults to 10. */
     groupIndent?: number;
     /** When printing you may want to apply a different group header from the one usually used in the table. You can now do this using the groupHeaderPrint table option, which takes the same inputs as the standard groupHeader property. */
@@ -2394,6 +2402,7 @@ export interface StarRatingParams {
 }
 export interface RowSelectionParams {
     rowRange?: RowRangeLookup;
+    disabled?: (rowData: Record<string, unknown>) => boolean;
 }
 export interface ToggleSwitchParams {
     size?: number;
@@ -3155,6 +3164,31 @@ export type IconFormatterParams = {
  * @property {Record<string, string>} [style] - Inline styles applied via Object.assign on the host style.
  * @property {string} [unitsFormat] - d, d-h, d-h-m, d-h-m-s, h, h-m, h-m-s, m, m-s, s (cx-format-time units-format).
  */
+export type AvatarFormatterParams = {
+    /** Initials to show when no image is available (1–2 characters). */
+    initials?: string;
+    /** Accessible label for the avatar. */
+    label?: string;
+    /** The shape of the avatar. */
+    shape?: 'circle' | 'rounded' | 'square';
+    /** CSS size override, e.g. '20px' or '2rem'. Defaults to '2rem'. */
+    size?: string;
+};
+export type DateFormatterParams = {
+    weekday?: FormatDateWeekday;
+    era?: FormatDateEra;
+    year?: FormatDateYear;
+    month?: FormatDateMonth;
+    day?: FormatDateDay;
+    hour?: FormatDateHour;
+    minute?: FormatDateMinute;
+    second?: FormatDateSecond;
+    timeZoneName?: FormatDateTimeZoneName;
+    timeZone?: string;
+    hourFormat?: FormatDateTimeZoneHour;
+    /** When true, removes the locale separator (e.g. " at " in en-US) between date and time parts. */
+    noDatetimeSeparator?: boolean;
+};
 export type TimeFormatterParams = {
     color?: string;
     fontSize?: string;
@@ -3262,24 +3296,9 @@ export type DiffFormatterParams = {
     /** Separator used when joining array values. Defaults to `', '`. */
     arraySeparator?: string;
 };
-export type TableDropdownFilterDataOption = {
-    filter?: Filter;
-    id: string;
-    label: string;
-};
-export type TableDropdownFilterData = {
-    field: string;
-    id: string;
-    label: string;
-    defaultOption?: string;
-    options: TableDropdownFilterDataOption[];
-};
-export type SavedSearchItem = {
-    recordID: string;
-    name: string;
-};
-export type SavedSearchAPIResponse = {
-    items: SavedSearchItem[];
-    totalCount: number;
-};
+export declare enum DateFilterCompareFormat {
+    IsoDate = "iso-date",
+    IsoDateTime = "iso-datetime",
+    Timestamp = "timestamp"
+}
 export {};

package/library/packages/utils/src/custom-element/i18n-utils.d.ts

@@ -65,6 +65,13 @@ export declare class LocalizeController<UserTranslation extends Translation = De
     languageName(language: string): string;
     /** Outputs a localized date in the specified format. */
     date(dateToFormat: Date | string, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Outputs a localized date/time without the locale connector literal
+     * (e.g. " at " in en-US) that Intl.DateTimeFormat inserts between date and
+     * time parts when both are present. Uses formatToParts() and replaces the
+     * connector literal with a plain space.
+     */
+    dateWithoutConnector(dateToFormat: Date | string, options?: Intl.DateTimeFormatOptions): string;
     /** Outputs a localized number in the specified format. */
     number(numberToFormat: number | string, options?: Intl.NumberFormatOptions): string;
     /** Outputs a localized time in relative format. */

package/library/packages/utils/src/custom-element/i18n.d.ts

@@ -408,6 +408,7 @@ export interface Translation extends DefaultTranslation {
     expo: string;
     export: string;
     exportAsCsv: string;
+    exportAsPdf: string;
     exportAsXml: string;
     extension: string;
     externalLink: string;