@ni/nimble-components 29.8.1 → 29.9.0

package/dist/esm/table-column/mixins/custom-sort-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-sort-order.js","sourceRoot":"","sources":["../../../../src/table-column/mixins/custom-sort-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,UAAU,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAWzD,4HAA4H;AAC5H,+HAA+H;AAC/H,MAAM,UAAU,6BAA6B,CAG3C,IAAW;IACT;;;OAGG;IACH,MAAe,qBAAsB,SAAQ,IAAI;QAAjD;;YAMI,gBAAgB;YACT,uCAAkC,GAAG;gBACxC,YAAY,EAAE,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;aAClE,CAAC;QAoEN,CAAC;QAlEU,qCAAqC,CACxC,uBAA2C;YAE3C,OAAO,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ;gBAC3C,CAAC,CAAC,IAAI,CAAC,eAAe;gBACtB,CAAC,CAAC,uBAAuB,CAAC;QAClC,CAAC;QAEM,wBAAwB,CAC3B,oBAA8C;YAE9C,OAAO,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ;gBAC3C,CAAC,CAAC,wBAAwB,CAAC,KAAK;gBAChC,CAAC,CAAC,oBAAoB,CAAC;QAC/B,CAAC;QAED,gBAAgB;QACT,sBAAsB;YACzB,IAAI,CAAC,6BAA6B,EAAE,CAAC;YACrC,IAAI,CAAC,iCAAiC,EAAE,CAAC;YAEzC,IACI,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ;mBACrC,CAAC,IAAI,CAAC,6BAA6B,EACxC;gBACE,IAAI,CAAC,6BAA6B,GAAG,UAAU,CAAC,WAAW,CACvD,IAAI,CAAC,eAAe,CACvB,CAAC;gBACF,IAAI,CAAC,6BAA6B,CAAC,SAAS,CACxC,IAAI,CAAC,kCAAkC,CAC1C,CAAC;aACL;iBAAM;gBACH,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAC3C,IAAI,CAAC,kCAAkC,CAC1C,CAAC;gBACF,IAAI,CAAC,6BAA6B,GAAG,SAAS,CAAC;aAClD;QACL,CAAC;QAID,gBAAgB;QACT,iCAAiC,CACpC,OAAgB,EAChB,IAAa;YAEb,IAAI,IAAI,KAAK,kBAAkB,EAAE;gBAC7B,IAAI,CAAC,iCAAiC,EAAE,CAAC;aAC5C;QACL,CAAC;QAED,gBAAgB;QACT,iCAAiC;YACpC,MAAM,sBAAsB,GAAG,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC;YACxE,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC;YACjE,MAAM,OAAO,GAAG,CAAC,iBAAiB,IAAI,CAAC,sBAAsB,CAAC;YAC9D,IAAI,OAAO,EAAE;gBACT,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,OAAO,CAClC,+BAA+B,CAClC,CAAC;aACL;iBAAM;gBACH,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,KAAK,CAChC,+BAA+B,CAClC,CAAC;aACL;QACL,CAAC;KACJ;IAED,IAAI,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC;IACrC,iEAAiE;IACjE,qBAAqB,CAAC,SAAS,EAC/B,iBAAiB,CACpB,CAAC;IAEF,OAAO,qBAAqB,CAAC;AACjC,CAAC","sourcesContent":["import { Notifier, Observable, attr } from '@microsoft/fast-element';\nimport type { TableColumn } from '../base';\nimport { TableColumnSortOperation } from '../base/types';\nimport type { ColumnValidator } from '../base/models/column-validator';\n\n// Pick just the relevant properties the mixin depends on (typescript complains if the mixin declares private / protected base exports)\ntype CustomSortOrderTableColumn<\n    TColumnValidator extends ColumnValidator<['invalidCustomSortWithGrouping']>\n> = Pick<TableColumn<unknown, TColumnValidator>, 'columnInternals'>;\n// prettier-ignore\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CustomSortOrderTableColumnConstructor<TColumnValidator extends ColumnValidator<['invalidCustomSortWithGrouping']>> = abstract new (...args: any[]) => CustomSortOrderTableColumn<TColumnValidator>;\n\n// As the returned class is internal to the function, we can't write a signature that uses is directly, so rely on inference\n// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/explicit-function-return-type\nexport function mixinCustomSortOrderColumnAPI<\n    TBase extends CustomSortOrderTableColumnConstructor<TColumnValidator>,\n    TColumnValidator extends ColumnValidator<['invalidCustomSortWithGrouping']>\n>(base: TBase) {\n    /**\n     * The Mixin that provides a concrete column with the API to allow sorting\n     * by a field other than the default for that column.\n     */\n    abstract class CustomSortOrderColumn extends base {\n        public sortByFieldName?: string;\n\n        /** @internal */\n        public customSortOrderColumnNotifier?: Notifier;\n\n        /** @internal */\n        public customSortOrderColumnChangeHandler = {\n            handleChange: this.handleCustomSortOrderColumnChange.bind(this)\n        };\n\n        public getResolvedOperandDataRecordFieldName(\n            initialOperandFieldName: string | undefined\n        ): string | undefined {\n            return typeof this.sortByFieldName === 'string'\n                ? this.sortByFieldName\n                : initialOperandFieldName;\n        }\n\n        public getResolvedSortOperation(\n            initialSortOperation: TableColumnSortOperation\n        ): TableColumnSortOperation {\n            return typeof this.sortByFieldName === 'string'\n                ? TableColumnSortOperation.basic\n                : initialSortOperation;\n        }\n\n        /** @internal */\n        public sortByFieldNameChanged(): void {\n            this.handleSortConfigurationChange();\n            this.updateCustomColumnSortingValidity();\n\n            if (\n                typeof this.sortByFieldName === 'string'\n                && !this.customSortOrderColumnNotifier\n            ) {\n                this.customSortOrderColumnNotifier = Observable.getNotifier(\n                    this.columnInternals\n                );\n                this.customSortOrderColumnNotifier.subscribe(\n                    this.customSortOrderColumnChangeHandler\n                );\n            } else {\n                this.customSortOrderColumnNotifier?.unsubscribe(\n                    this.customSortOrderColumnChangeHandler\n                );\n                this.customSortOrderColumnNotifier = undefined;\n            }\n        }\n\n        public abstract handleSortConfigurationChange(): void;\n\n        /** @internal */\n        public handleCustomSortOrderColumnChange(\n            _source: unknown,\n            args: unknown\n        ): void {\n            if (args === 'groupingDisabled') {\n                this.updateCustomColumnSortingValidity();\n            }\n        }\n\n        /** @internal */\n        public updateCustomColumnSortingValidity(): void {\n            const hasCustomColumnSorting = typeof this.sortByFieldName === 'string';\n            const isGroupingEnabled = !this.columnInternals.groupingDisabled;\n            const isValid = !isGroupingEnabled || !hasCustomColumnSorting;\n            if (isValid) {\n                this.columnInternals.validator.untrack(\n                    'invalidCustomSortWithGrouping'\n                );\n            } else {\n                this.columnInternals.validator.track(\n                    'invalidCustomSortWithGrouping'\n                );\n            }\n        }\n    }\n\n    attr({ attribute: 'sort-by-field-name' })(\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        CustomSortOrderColumn.prototype,\n        'sortByFieldName'\n    );\n\n    return CustomSortOrderColumn;\n}\n"]}

package/dist/esm/table-column/text/index.d.ts

@@ -1,8 +1,9 @@
 import type { TableStringField } from '../../table/types';
 import { TableColumnTextBase } from '../text-base';
+import { TableColumnSortOperation } from '../base/types';
 import type { ColumnInternalsOptions } from '../base/models/column-internals';
 import type { TableColumnTextBaseColumnConfig } from '../text-base/cell-view';
-import { ColumnValidator } from '../base/models/column-validator';
+import { TableColumnTextValidator } from './models/table-column-text-validator';
 export type TableColumnTextCellRecord = TableStringField<'value'>;
 export interface TableColumnTextColumnConfig extends TableColumnTextBaseColumnConfig {
 }
@@ -12,17 +13,30 @@ declare global {
     }
 }
 declare const TableColumnText_base: (abstract new (...args: any[]) => {
+    sortByFieldName?: string | undefined;
+    customSortOrderColumnNotifier?: import("@microsoft/fast-element").Notifier | undefined;
+    customSortOrderColumnChangeHandler: {
+        handleChange: (_source: unknown, args: unknown) => void;
+    };
+    getResolvedOperandDataRecordFieldName(initialOperandFieldName: string | undefined): string | undefined;
+    getResolvedSortOperation(initialSortOperation: TableColumnSortOperation): TableColumnSortOperation;
+    sortByFieldNameChanged(): void;
+    handleSortConfigurationChange(): void;
+    handleCustomSortOrderColumnChange(_source: unknown, args: unknown): void;
+    updateCustomColumnSortingValidity(): void;
+    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, import("../base/models/column-validator").ColumnValidator<["invalidCustomSortWithGrouping"]>>;
+}) & (abstract new (...args: any[]) => {
     groupingDisabled: boolean;
     groupIndex?: number | null | undefined;
     groupingDisabledChanged(): void;
     groupIndexChanged(): void;
-    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, ColumnValidator<[]>>;
+    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, import("../base/models/column-validator").ColumnValidator<[]>>;
 }) & (abstract new (...args: any[]) => {
     fractionalWidth?: number | null | undefined;
     minPixelWidth?: number | null | undefined;
     fractionalWidthChanged(): void;
     minPixelWidthChanged(): void;
-    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, ColumnValidator<[]>>;
+    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, import("../base/models/column-validator").ColumnValidator<[]>>;
 }) & (abstract new (...args: any[]) => {
     placeholder?: string | undefined;
     placeholderChanged(): void;
@@ -33,8 +47,8 @@ declare const TableColumnText_base: (abstract new (...args: any[]) => {
     sortingDisabledChanged(): void;
     sortDirectionChanged(): void;
     sortIndexChanged(): void;
-    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, ColumnValidator<[]>>;
-}) & ((abstract new () => TableColumnTextBase<TableColumnTextColumnConfig, ColumnValidator<[]>>) & {
+    readonly columnInternals: import("../base/models/column-internals").ColumnInternals<unknown, import("../base/models/column-validator").ColumnValidator<[]>>;
+}) & ((abstract new () => TableColumnTextBase<TableColumnTextColumnConfig, TableColumnTextValidator>) & {
     compose<T extends import("@microsoft/fast-foundation").FoundationElementDefinition = import("@microsoft/fast-foundation").FoundationElementDefinition, K extends import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement> = import("@microsoft/fast-element").Constructable<import("@microsoft/fast-foundation").FoundationElement>>(this: K, elementDefinition: T): (overrideDefinition?: import("@microsoft/fast-foundation").OverrideFoundationElementDefinition<T> | undefined) => import("@microsoft/fast-foundation").FoundationElementRegistry<T, K>;
     from<TBase extends {
         new (): HTMLElement;
@@ -46,8 +60,12 @@ declare const TableColumnText_base: (abstract new (...args: any[]) => {
  * The table column for displaying string fields as text.
  */
 export declare class TableColumnText extends TableColumnText_base {
+    private readonly defaultSortOperation;
     placeholderChanged(): void;
-    protected getColumnInternalsOptions(): ColumnInternalsOptions;
+    handleSortConfigurationChange(): void;
+    protected getColumnInternalsOptions(): ColumnInternalsOptions<TableColumnTextValidator>;
+    protected fieldNameChanged(): void;
+    private updateColumnInternalsSortConfiguration;
 }
 export declare const tableColumnTextTag = "nimble-table-column-text";
 export {};

package/dist/esm/table-column/text/index.js

@@ -5,26 +5,42 @@ import { TableColumnTextBase, mixinTextBase } from '../text-base';
 import { TableColumnSortOperation } from '../base/types';
 import { tableColumnTextGroupHeaderViewTag } from './group-header-view';
 import { tableColumnTextCellViewTag } from './cell-view';
-import { ColumnValidator } from '../base/models/column-validator';
+import { mixinCustomSortOrderColumnAPI } from '../mixins/custom-sort-order';
+import { TableColumnTextValidator } from './models/table-column-text-validator';
 /**
  * The table column for displaying string fields as text.
  */
-export class TableColumnText extends mixinTextBase((TableColumnTextBase)) {
+export class TableColumnText extends mixinCustomSortOrderColumnAPI(mixinTextBase((TableColumnTextBase))) {
+    constructor() {
+        super(...arguments);
+        this.defaultSortOperation = TableColumnSortOperation.localeAwareCaseSensitive;
+    }
     placeholderChanged() {
         this.columnInternals.columnConfig = {
             placeholder: this.placeholder
         };
     }
+    handleSortConfigurationChange() {
+        this.updateColumnInternalsSortConfiguration();
+    }
     getColumnInternalsOptions() {
         return {
             cellRecordFieldNames: ['value'],
             cellViewTag: tableColumnTextCellViewTag,
             groupHeaderViewTag: tableColumnTextGroupHeaderViewTag,
             delegatedEvents: [],
-            sortOperation: TableColumnSortOperation.localeAwareCaseSensitive,
-            validator: new ColumnValidator([])
+            sortOperation: this.getResolvedSortOperation(this.defaultSortOperation),
+            validator: new TableColumnTextValidator()
         };
     }
+    fieldNameChanged() {
+        this.columnInternals.dataRecordFieldNames = [this.fieldName];
+        this.updateColumnInternalsSortConfiguration();
+    }
+    updateColumnInternalsSortConfiguration() {
+        this.columnInternals.operandDataRecordFieldName = this.getResolvedOperandDataRecordFieldName(this.fieldName);
+        this.columnInternals.sortOperation = this.getResolvedSortOperation(this.defaultSortOperation);
+    }
 }
 const nimbleTableColumnText = TableColumnText.compose({
     baseName: 'table-column-text',

package/dist/esm/table-column/text/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/table-column/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAclE;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa,CAC9C,CAAA,mBAAgD,CAAA,CACnD;IACU,kBAAkB;QACrB,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW;SAChC,CAAC;IACN,CAAC;IAEkB,yBAAyB;QACxC,OAAO;YACH,oBAAoB,EAAE,CAAC,OAAO,CAAC;YAC/B,WAAW,EAAE,0BAA0B;YACvC,kBAAkB,EAAE,iCAAiC;YACrD,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,wBAAwB,CAAC,wBAAwB;YAChE,SAAS,EAAE,IAAI,eAAe,CAAK,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;CACJ;AAED,MAAM,qBAAqB,GAAG,eAAe,CAAC,OAAO,CAAC;IAClD,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE;KACrB,UAAU,CAAC,QAAQ,CAAC;KACpB,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC","sourcesContent":["import { DesignSystem } from '@microsoft/fast-foundation';\nimport { styles } from '../base/styles';\nimport { template } from '../base/template';\nimport type { TableStringField } from '../../table/types';\nimport { TableColumnTextBase, mixinTextBase } from '../text-base';\nimport { TableColumnSortOperation } from '../base/types';\nimport { tableColumnTextGroupHeaderViewTag } from './group-header-view';\nimport { tableColumnTextCellViewTag } from './cell-view';\nimport type { ColumnInternalsOptions } from '../base/models/column-internals';\nimport type { TableColumnTextBaseColumnConfig } from '../text-base/cell-view';\nimport { ColumnValidator } from '../base/models/column-validator';\n\nexport type TableColumnTextCellRecord = TableStringField<'value'>;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface TableColumnTextColumnConfig\n    extends TableColumnTextBaseColumnConfig {}\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'nimble-table-column-text': TableColumnText;\n    }\n}\n\n/**\n * The table column for displaying string fields as text.\n */\nexport class TableColumnText extends mixinTextBase(\n    TableColumnTextBase<TableColumnTextColumnConfig>\n) {\n    public placeholderChanged(): void {\n        this.columnInternals.columnConfig = {\n            placeholder: this.placeholder\n        };\n    }\n\n    protected override getColumnInternalsOptions(): ColumnInternalsOptions {\n        return {\n            cellRecordFieldNames: ['value'],\n            cellViewTag: tableColumnTextCellViewTag,\n            groupHeaderViewTag: tableColumnTextGroupHeaderViewTag,\n            delegatedEvents: [],\n            sortOperation: TableColumnSortOperation.localeAwareCaseSensitive,\n            validator: new ColumnValidator<[]>([])\n        };\n    }\n}\n\nconst nimbleTableColumnText = TableColumnText.compose({\n    baseName: 'table-column-text',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate()\n    .withPrefix('nimble')\n    .register(nimbleTableColumnText());\nexport const tableColumnTextTag = 'nimble-table-column-text';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/table-column/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAchF;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,6BAA6B,CAC9D,aAAa,CACT,CAAA,mBAGC,CAAA,CACJ,CACJ;IAPD;;QAQqB,yBAAoB,GAAG,wBAAwB,CAAC,wBAAwB,CAAC;IAoC9F,CAAC;IAlCU,kBAAkB;QACrB,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW;SAChC,CAAC;IACN,CAAC;IAEe,6BAA6B;QACzC,IAAI,CAAC,sCAAsC,EAAE,CAAC;IAClD,CAAC;IAEkB,yBAAyB;QACxC,OAAO;YACH,oBAAoB,EAAE,CAAC,OAAO,CAAC;YAC/B,WAAW,EAAE,0BAA0B;YACvC,kBAAkB,EAAE,iCAAiC;YACrD,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,IAAI,CAAC,wBAAwB,CACxC,IAAI,CAAC,oBAAoB,CAC5B;YACD,SAAS,EAAE,IAAI,wBAAwB,EAAE;SAC5C,CAAC;IACN,CAAC;IAEkB,gBAAgB;QAC/B,IAAI,CAAC,eAAe,CAAC,oBAAoB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAU,CAAC;QACtE,IAAI,CAAC,sCAAsC,EAAE,CAAC;IAClD,CAAC;IAEO,sCAAsC;QAC1C,IAAI,CAAC,eAAe,CAAC,0BAA0B,GAAG,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7G,IAAI,CAAC,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC,wBAAwB,CAC9D,IAAI,CAAC,oBAAoB,CAC5B,CAAC;IACN,CAAC;CACJ;AAED,MAAM,qBAAqB,GAAG,eAAe,CAAC,OAAO,CAAC;IAClD,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE;KACrB,UAAU,CAAC,QAAQ,CAAC;KACpB,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC","sourcesContent":["import { DesignSystem } from '@microsoft/fast-foundation';\nimport { styles } from '../base/styles';\nimport { template } from '../base/template';\nimport type { TableStringField } from '../../table/types';\nimport { TableColumnTextBase, mixinTextBase } from '../text-base';\nimport { TableColumnSortOperation } from '../base/types';\nimport { tableColumnTextGroupHeaderViewTag } from './group-header-view';\nimport { tableColumnTextCellViewTag } from './cell-view';\nimport type { ColumnInternalsOptions } from '../base/models/column-internals';\nimport type { TableColumnTextBaseColumnConfig } from '../text-base/cell-view';\nimport { mixinCustomSortOrderColumnAPI } from '../mixins/custom-sort-order';\nimport { TableColumnTextValidator } from './models/table-column-text-validator';\n\nexport type TableColumnTextCellRecord = TableStringField<'value'>;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface TableColumnTextColumnConfig\n    extends TableColumnTextBaseColumnConfig {}\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'nimble-table-column-text': TableColumnText;\n    }\n}\n\n/**\n * The table column for displaying string fields as text.\n */\nexport class TableColumnText extends mixinCustomSortOrderColumnAPI(\n    mixinTextBase(\n        TableColumnTextBase<\n        TableColumnTextColumnConfig,\n        TableColumnTextValidator\n        >\n    )\n) {\n    private readonly defaultSortOperation = TableColumnSortOperation.localeAwareCaseSensitive;\n\n    public placeholderChanged(): void {\n        this.columnInternals.columnConfig = {\n            placeholder: this.placeholder\n        };\n    }\n\n    public override handleSortConfigurationChange(): void {\n        this.updateColumnInternalsSortConfiguration();\n    }\n\n    protected override getColumnInternalsOptions(): ColumnInternalsOptions<TableColumnTextValidator> {\n        return {\n            cellRecordFieldNames: ['value'],\n            cellViewTag: tableColumnTextCellViewTag,\n            groupHeaderViewTag: tableColumnTextGroupHeaderViewTag,\n            delegatedEvents: [],\n            sortOperation: this.getResolvedSortOperation(\n                this.defaultSortOperation\n            ),\n            validator: new TableColumnTextValidator()\n        };\n    }\n\n    protected override fieldNameChanged(): void {\n        this.columnInternals.dataRecordFieldNames = [this.fieldName] as const;\n        this.updateColumnInternalsSortConfiguration();\n    }\n\n    private updateColumnInternalsSortConfiguration(): void {\n        this.columnInternals.operandDataRecordFieldName = this.getResolvedOperandDataRecordFieldName(this.fieldName);\n        this.columnInternals.sortOperation = this.getResolvedSortOperation(\n            this.defaultSortOperation\n        );\n    }\n}\n\nconst nimbleTableColumnText = TableColumnText.compose({\n    baseName: 'table-column-text',\n    template,\n    styles\n});\n\nDesignSystem.getOrCreate()\n    .withPrefix('nimble')\n    .register(nimbleTableColumnText());\nexport const tableColumnTextTag = 'nimble-table-column-text';\n"]}

package/dist/esm/table-column/text/models/table-column-text-validator.d.ts

@@ -0,0 +1,8 @@
+import { ColumnValidator } from '../../base/models/column-validator';
+export declare const columnTextValidityFlagNames: readonly ["invalidCustomSortWithGrouping"];
+/**
+ * Validator class for the text table column.
+ */
+export declare class TableColumnTextValidator extends ColumnValidator<typeof columnTextValidityFlagNames> {
+    constructor();
+}

package/dist/esm/table-column/text/models/table-column-text-validator.js

@@ -0,0 +1,13 @@
+import { ColumnValidator } from '../../base/models/column-validator';
+export const columnTextValidityFlagNames = [
+    'invalidCustomSortWithGrouping'
+];
+/**
+ * Validator class for the text table column.
+ */
+export class TableColumnTextValidator extends ColumnValidator {
+    constructor() {
+        super(columnTextValidityFlagNames);
+    }
+}
+//# sourceMappingURL=table-column-text-validator.js.map

package/dist/esm/table-column/text/models/table-column-text-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-column-text-validator.js","sourceRoot":"","sources":["../../../../../src/table-column/text/models/table-column-text-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,+BAA+B;CACzB,CAAC;AAEX;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAE7C;IACG;QACI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACvC,CAAC;CACJ","sourcesContent":["import { ColumnValidator } from '../../base/models/column-validator';\n\nexport const columnTextValidityFlagNames = [\n    'invalidCustomSortWithGrouping'\n] as const;\n\n/**\n * Validator class for the text table column.\n */\nexport class TableColumnTextValidator extends ColumnValidator<\n    typeof columnTextValidityFlagNames\n> {\n    public constructor() {\n        super(columnTextValidityFlagNames);\n    }\n}\n"]}

package/dist/esm/utilities/models/tracker.d.ts

@@ -16,6 +16,7 @@ export declare class Tracker<TrackedItemsList extends readonly string[]> {
     allTracked(): boolean;
     anyTracked(): boolean;
     noneTracked(): boolean;
+    onTrackingChange(): void;
     private setAllKeys;
 }
 export {};

package/dist/esm/utilities/models/tracker.js

@@ -18,16 +18,32 @@ export class Tracker {
         return this.trackedItems[key];
     }
     track(key) {
-        this.trackedItems[key] = true;
+        const wasTracked = this.trackedItems[key];
+        if (!wasTracked) {
+            this.trackedItems[key] = true;
+            this.onTrackingChange();
+        }
     }
     untrack(key) {
-        this.trackedItems[key] = false;
+        const wasTracked = this.trackedItems[key];
+        if (wasTracked) {
+            this.trackedItems[key] = false;
+            this.onTrackingChange();
+        }
     }
     trackAll() {
+        if (this.allTracked()) {
+            return;
+        }
         this.setAllKeys(true);
+        this.onTrackingChange();
     }
     untrackAll() {
+        if (this.noneTracked()) {
+            return;
+        }
         this.setAllKeys(false);
+        this.onTrackingChange();
     }
     allTracked() {
         return Object.values(this.trackedItems).every(x => x);
@@ -38,6 +54,7 @@ export class Tracker {
     noneTracked() {
         return Object.values(this.trackedItems).every(x => !x);
     }
+    onTrackingChange() { }
     setAllKeys(value) {
         this.trackedItems = Object.keys(this.trackedItems).reduce((r, key) => {
             return {

package/dist/esm/utilities/models/tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../../src/utilities/models/tracker.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,OAAO;IAGhB,YAAmB,gBAAkC;QAEjD,IAAI,CAAC,YAAY,GAAG,EAAkB,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,gBAAgB,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,GAAG,EAAgB,EAAE;YACrB,OAAO;gBACH,GAAG,CAAC;gBACJ,CAAC,GAAG,CAAC,EAAE,KAAK;aACf,CAAC;QACN,CAAC,EACD,IAAI,CAAC,YAAY,CACpB,CAAC;IACN,CAAC;IAEM,eAAe;QAClB,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAEM,SAAS,CAAC,GAA2C;QACxD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,GAA2C;QACpD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAClC,CAAC;IAEM,OAAO,CAAC,GAA2C;QACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnC,CAAC;IAEM,QAAQ;QACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEM,UAAU;QACb,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAEM,UAAU;QACb,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,UAAU;QACb,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAEM,WAAW;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,UAAU,CAAC,KAAc;QAE7B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,GAAG,EAAgB,EAAE;YACrB,OAAO;gBACH,GAAG,CAAC;gBACJ,CAAC,GAAG,CAAC,EAAE,KAAK;aACf,CAAC;QACN,CAAC,EACD,IAAI,CAAC,YAAY,CACpB,CAAC;IACN,CAAC;CACJ","sourcesContent":["type ObjectFromList<T extends readonly string[]> = {\n    [K in T extends readonly (infer U)[] ? U : never]: boolean;\n};\n\n/**\n * Generic Tracker which sets or resets provided flags\n */\nexport class Tracker<TrackedItemsList extends readonly string[]> {\n    private trackedItems: ObjectFromList<TrackedItemsList>;\n\n    public constructor(trackedItemsList: TrackedItemsList) {\n        type TrackedItems = typeof this.trackedItems;\n        this.trackedItems = {} as TrackedItems;\n        this.trackedItems = trackedItemsList.reduce<TrackedItems>(\n            (r, key): TrackedItems => {\n                return {\n                    ...r,\n                    [key]: false\n                };\n            },\n            this.trackedItems\n        );\n    }\n\n    public getTrackedItems(): ObjectFromList<TrackedItemsList> {\n        return { ...this.trackedItems };\n    }\n\n    public isTracked(key: keyof ObjectFromList<TrackedItemsList>): boolean {\n        return this.trackedItems[key];\n    }\n\n    public track(key: keyof ObjectFromList<TrackedItemsList>): void {\n        this.trackedItems[key] = true;\n    }\n\n    public untrack(key: keyof ObjectFromList<TrackedItemsList>): void {\n        this.trackedItems[key] = false;\n    }\n\n    public trackAll(): void {\n        this.setAllKeys(true);\n    }\n\n    public untrackAll(): void {\n        this.setAllKeys(false);\n    }\n\n    public allTracked(): boolean {\n        return Object.values(this.trackedItems).every(x => x);\n    }\n\n    public anyTracked(): boolean {\n        return Object.values(this.trackedItems).some(x => x);\n    }\n\n    public noneTracked(): boolean {\n        return Object.values(this.trackedItems).every(x => !x);\n    }\n\n    private setAllKeys(value: boolean): void {\n        type TrackedItems = typeof this.trackedItems;\n        this.trackedItems = Object.keys(this.trackedItems).reduce<TrackedItems>(\n            (r, key): TrackedItems => {\n                return {\n                    ...r,\n                    [key]: value\n                };\n            },\n            this.trackedItems\n        );\n    }\n}\n"]}
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../../src/utilities/models/tracker.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,OAAO;IAGhB,YAAmB,gBAAkC;QAEjD,IAAI,CAAC,YAAY,GAAG,EAAkB,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,gBAAgB,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,GAAG,EAAgB,EAAE;YACrB,OAAO;gBACH,GAAG,CAAC;gBACJ,CAAC,GAAG,CAAC,EAAE,KAAK;aACf,CAAC;QACN,CAAC,EACD,IAAI,CAAC,YAAY,CACpB,CAAC;IACN,CAAC;IAEM,eAAe;QAClB,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAEM,SAAS,CAAC,GAA2C;QACxD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,GAA2C;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE;YACb,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAC9B,IAAI,CAAC,gBAAgB,EAAE,CAAC;SAC3B;IACL,CAAC;IAEM,OAAO,CAAC,GAA2C;QACtD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,UAAU,EAAE;YACZ,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;SAC3B;IACL,CAAC;IAEM,QAAQ;QACX,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;YACnB,OAAO;SACV;QAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAEM,UAAU;QACb,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE;YACpB,OAAO;SACV;QAED,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAEM,UAAU;QACb,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,UAAU;QACb,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAEM,WAAW;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEM,gBAAgB,KAAU,CAAC;IAE1B,UAAU,CAAC,KAAc;QAE7B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,GAAG,EAAgB,EAAE;YACrB,OAAO;gBACH,GAAG,CAAC;gBACJ,CAAC,GAAG,CAAC,EAAE,KAAK;aACf,CAAC;QACN,CAAC,EACD,IAAI,CAAC,YAAY,CACpB,CAAC;IACN,CAAC;CACJ","sourcesContent":["type ObjectFromList<T extends readonly string[]> = {\n    [K in T extends readonly (infer U)[] ? U : never]: boolean;\n};\n\n/**\n * Generic Tracker which sets or resets provided flags\n */\nexport class Tracker<TrackedItemsList extends readonly string[]> {\n    private trackedItems: ObjectFromList<TrackedItemsList>;\n\n    public constructor(trackedItemsList: TrackedItemsList) {\n        type TrackedItems = typeof this.trackedItems;\n        this.trackedItems = {} as TrackedItems;\n        this.trackedItems = trackedItemsList.reduce<TrackedItems>(\n            (r, key): TrackedItems => {\n                return {\n                    ...r,\n                    [key]: false\n                };\n            },\n            this.trackedItems\n        );\n    }\n\n    public getTrackedItems(): ObjectFromList<TrackedItemsList> {\n        return { ...this.trackedItems };\n    }\n\n    public isTracked(key: keyof ObjectFromList<TrackedItemsList>): boolean {\n        return this.trackedItems[key];\n    }\n\n    public track(key: keyof ObjectFromList<TrackedItemsList>): void {\n        const wasTracked = this.trackedItems[key];\n        if (!wasTracked) {\n            this.trackedItems[key] = true;\n            this.onTrackingChange();\n        }\n    }\n\n    public untrack(key: keyof ObjectFromList<TrackedItemsList>): void {\n        const wasTracked = this.trackedItems[key];\n        if (wasTracked) {\n            this.trackedItems[key] = false;\n            this.onTrackingChange();\n        }\n    }\n\n    public trackAll(): void {\n        if (this.allTracked()) {\n            return;\n        }\n\n        this.setAllKeys(true);\n        this.onTrackingChange();\n    }\n\n    public untrackAll(): void {\n        if (this.noneTracked()) {\n            return;\n        }\n\n        this.setAllKeys(false);\n        this.onTrackingChange();\n    }\n\n    public allTracked(): boolean {\n        return Object.values(this.trackedItems).every(x => x);\n    }\n\n    public anyTracked(): boolean {\n        return Object.values(this.trackedItems).some(x => x);\n    }\n\n    public noneTracked(): boolean {\n        return Object.values(this.trackedItems).every(x => !x);\n    }\n\n    public onTrackingChange(): void {}\n\n    private setAllKeys(value: boolean): void {\n        type TrackedItems = typeof this.trackedItems;\n        this.trackedItems = Object.keys(this.trackedItems).reduce<TrackedItems>(\n            (r, key): TrackedItems => {\n                return {\n                    ...r,\n                    [key]: value\n                };\n            },\n            this.trackedItems\n        );\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni/nimble-components",
-  "version": "29.8.1",
+  "version": "29.9.0",
   "description": "Styled web components for the NI Nimble Design System",
   "scripts": {
     "build": "npm run generate-icons && npm run generate-workers && npm run build-components && npm run bundle-components && npm run generate-scss",
@@ -44,7 +44,7 @@
     "test-webkit:verbose": "karma start karma.conf.verbose.js --browsers=WebkitHeadless --single-run --skip-tags SkipWebkit",
     "test-webkit:watch": "karma start karma.conf.js --browsers=WebkitHeadless --skip-tags SkipWebkit --watch-extensions js",
     "test-webkit": "karma start karma.conf.js --browsers=WebkitHeadless --single-run --skip-tags SkipWebkit",
-    "test-concurrent": "concurrently --timings --group \"npm:test-chrome:verbose\" \"npm:test-firefox:verbose\""
+    "test-concurrent": "concurrently --timings --group \"npm:test-chrome:verbose\" \"npm:test-firefox:verbose\" \"npm:test-webkit:verbose\""
   },
   "repository": {
     "type": "git",
@@ -124,7 +124,7 @@
     "karma-source-map-support": "^1.4.0",
     "karma-sourcemap-loader": "^0.4.0",
     "karma-spec-reporter": "^0.0.36",
-    "karma-webkit-launcher": "^2.1.0",
+    "karma-webkit-launcher": "^2.6.0",
     "karma-webpack": "^5.0.0",
     "playwright": "1.44.0",
     "prettier-eslint": "^16.3.0",