@ni/nimble-components 20.1.9 → 20.1.10

package/dist/esm/src/table-column/number-text/cell-view/index.d.ts

@@ -0,0 +1,16 @@
+import type { TableColumnNumberTextCellRecord, TableColumnNumberTextColumnConfig } from '..';
+import { TableColumnTextCellViewBase } from '../../text-base/cell-view';
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text-cell-view': TableColumnNumberTextCellView;
+    }
+}
+/**
+ * A cell view for displaying number fields as text
+ */
+export declare class TableColumnNumberTextCellView extends TableColumnTextCellViewBase<TableColumnNumberTextCellRecord, TableColumnNumberTextColumnConfig> {
+    private columnConfigChanged;
+    private cellRecordChanged;
+    private updateText;
+}
+export declare const tableColumnNumberTextCellViewTag: string;

package/dist/esm/src/table-column/number-text/group-header-view/index.d.ts

@@ -0,0 +1,17 @@
+import type { TableNumberFieldValue } from '../../../table/types';
+import { TableColumnTextGroupHeaderViewBase } from '../../text-base/group-header-view';
+import type { TableColumnNumberTextColumnConfig } from '..';
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text-group-header': TableColumnNumberTextGroupHeaderView;
+    }
+}
+/**
+ * The group header view for displaying number fields as text.
+ */
+export declare class TableColumnNumberTextGroupHeaderView extends TableColumnTextGroupHeaderViewBase<TableNumberFieldValue, TableColumnNumberTextColumnConfig> {
+    private columnConfigChanged;
+    private groupHeaderValueChanged;
+    private updateText;
+}
+export declare const tableColumnNumberTextGroupHeaderTag: string;

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

@@ -0,0 +1,26 @@
+import type { TableNumberField } from '../../table/types';
+import { TableColumnTextBase } from '../text-base';
+import type { ColumnInternalsOptions } from '../base/models/column-internals';
+import { NumberTextFormat } from './types';
+import type { NumberFormatter } from './models/number-formatter';
+export declare type TableColumnNumberTextCellRecord = TableNumberField<'value'>;
+export interface TableColumnNumberTextColumnConfig {
+    formatter: NumberFormatter;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text': TableColumnNumberText;
+    }
+}
+/**
+ * The table column for displaying numbers as text.
+ */
+export declare class TableColumnNumberText extends TableColumnTextBase {
+    format: NumberTextFormat;
+    connectedCallback(): void;
+    protected getColumnInternalsOptions(): ColumnInternalsOptions;
+    private formatChanged;
+    private updateColumnConfig;
+    private createFormatter;
+}
+export declare const tableColumnNumberTextTag: string;

package/dist/esm/src/table-column/number-text/models/default-formatter.d.ts

@@ -0,0 +1,14 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'default'.
+ */
+export declare class DefaultFormatter extends NumberFormatter {
+    private static readonly maximumDigits;
+    private static readonly exponentialLowerBound;
+    private static readonly exponentialUpperBound;
+    private static readonly defaultFormatter;
+    private static readonly leadingZeroFormatter;
+    private static readonly exponentialFormatter;
+    protected format(number: number): string;
+    private getFormatterForNumber;
+}

package/dist/esm/src/table-column/number-text/models/number-formatter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The base class for number formatters used by the number-text column.
+ */
+export declare abstract class NumberFormatter {
+    /**
+     * Tries to format the passed value using the `format()` function implemented by a concrete implementation of the class.
+     * Returns an empty string if the value is not a number or if `format()` throws an error.
+     */
+    formatValue(value: number | undefined | null): string;
+    protected abstract format(number: number): string;
+}

package/dist/esm/src/table-column/number-text/models/round-to-integer-formatter.d.ts

@@ -0,0 +1,8 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'roundToInteger'.
+ */
+export declare class RoundToIntegerFormatter extends NumberFormatter {
+    private static readonly formatter;
+    protected format(number: number): string;
+}

package/dist/esm/src/table-column/number-text/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Formatting scheme for the number-text table column
+ */
+export declare const NumberTextFormat: {
+    readonly default: undefined;
+    readonly roundToInteger: "round-to-integer";
+};
+export declare type NumberTextFormat = (typeof NumberTextFormat)[keyof typeof NumberTextFormat];

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

@@ -0,0 +1,16 @@
+import type { TableColumnNumberTextCellRecord, TableColumnNumberTextColumnConfig } from '..';
+import { TableColumnTextCellViewBase } from '../../text-base/cell-view';
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text-cell-view': TableColumnNumberTextCellView;
+    }
+}
+/**
+ * A cell view for displaying number fields as text
+ */
+export declare class TableColumnNumberTextCellView extends TableColumnTextCellViewBase<TableColumnNumberTextCellRecord, TableColumnNumberTextColumnConfig> {
+    private columnConfigChanged;
+    private cellRecordChanged;
+    private updateText;
+}
+export declare const tableColumnNumberTextCellViewTag: string;

package/dist/esm/table-column/number-text/cell-view/index.js

@@ -0,0 +1,27 @@
+import { DesignSystem } from '@microsoft/fast-foundation';
+import { template } from '../../text-base/cell-view/template';
+import { styles } from '../../text-base/cell-view/styles';
+import { TableColumnTextCellViewBase } from '../../text-base/cell-view';
+/**
+ * A cell view for displaying number fields as text
+ */
+export class TableColumnNumberTextCellView extends TableColumnTextCellViewBase {
+    columnConfigChanged() {
+        this.updateText();
+    }
+    cellRecordChanged() {
+        this.updateText();
+    }
+    updateText() {
+        this.text = this.columnConfig?.formatter?.formatValue(this.cellRecord?.value)
+            ?? '';
+    }
+}
+const numberTextCellView = TableColumnNumberTextCellView.compose({
+    baseName: 'table-column-number-text-cell-view',
+    template,
+    styles
+});
+DesignSystem.getOrCreate().withPrefix('nimble').register(numberTextCellView());
+export const tableColumnNumberTextCellViewTag = DesignSystem.tagFor(TableColumnNumberTextCellView);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/table-column/number-text/cell-view/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAK9D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAQxE;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,2BAGlD;IACW,mBAAmB;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAEO,iBAAiB;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAEO,UAAU;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;eACtE,EAAE,CAAC;IACd,CAAC;CACJ;AAED,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,OAAO,CAAC;IAC7D,QAAQ,EAAE,oCAAoC;IAC9C,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AACH,YAAY,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAAC,MAAM,CAC/D,6BAA6B,CAChC,CAAC"}

package/dist/esm/table-column/number-text/group-header-view/index.d.ts

@@ -0,0 +1,17 @@
+import type { TableNumberFieldValue } from '../../../table/types';
+import { TableColumnTextGroupHeaderViewBase } from '../../text-base/group-header-view';
+import type { TableColumnNumberTextColumnConfig } from '..';
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text-group-header': TableColumnNumberTextGroupHeaderView;
+    }
+}
+/**
+ * The group header view for displaying number fields as text.
+ */
+export declare class TableColumnNumberTextGroupHeaderView extends TableColumnTextGroupHeaderViewBase<TableNumberFieldValue, TableColumnNumberTextColumnConfig> {
+    private columnConfigChanged;
+    private groupHeaderValueChanged;
+    private updateText;
+}
+export declare const tableColumnNumberTextGroupHeaderTag: string;

package/dist/esm/table-column/number-text/group-header-view/index.js

@@ -0,0 +1,29 @@
+import { DesignSystem } from '@microsoft/fast-foundation';
+import { TableColumnTextGroupHeaderViewBase } from '../../text-base/group-header-view';
+import { template } from '../../text-base/group-header-view/template';
+import { styles } from '../../text-base/group-header-view/styles';
+/**
+ * The group header view for displaying number fields as text.
+ */
+export class TableColumnNumberTextGroupHeaderView extends TableColumnTextGroupHeaderViewBase {
+    columnConfigChanged() {
+        this.updateText();
+    }
+    groupHeaderValueChanged() {
+        this.updateText();
+    }
+    updateText() {
+        this.text = this.columnConfig?.formatter?.formatValue(this.groupHeaderValue)
+            ?? '';
+    }
+}
+const tableColumnNumberTextGroupHeaderView = TableColumnNumberTextGroupHeaderView.compose({
+    baseName: 'table-column-number-text-group-header-view',
+    template,
+    styles
+});
+DesignSystem.getOrCreate()
+    .withPrefix('nimble')
+    .register(tableColumnNumberTextGroupHeaderView());
+export const tableColumnNumberTextGroupHeaderTag = DesignSystem.tagFor(TableColumnNumberTextGroupHeaderView);
+//# sourceMappingURL=index.js.map

package/dist/esm/table-column/number-text/group-header-view/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/table-column/number-text/group-header-view/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,0CAA0C,CAAC;AAQlE;;GAEG;AACH,MAAM,OAAO,oCAAqC,SAAQ,kCAGzD;IACW,mBAAmB;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAEO,uBAAuB;QAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAEO,UAAU;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC;eACrE,EAAE,CAAC;IACd,CAAC;CACJ;AAED,MAAM,oCAAoC,GAAG,oCAAoC,CAAC,OAAO,CAAC;IACtF,QAAQ,EAAE,4CAA4C;IACtD,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AACH,YAAY,CAAC,WAAW,EAAE;KACrB,UAAU,CAAC,QAAQ,CAAC;KACpB,QAAQ,CAAC,oCAAoC,EAAE,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,mCAAmC,GAAG,YAAY,CAAC,MAAM,CAClE,oCAAoC,CACvC,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { TableNumberField } from '../../table/types';
+import { TableColumnTextBase } from '../text-base';
+import type { ColumnInternalsOptions } from '../base/models/column-internals';
+import { NumberTextFormat } from './types';
+import type { NumberFormatter } from './models/number-formatter';
+export declare type TableColumnNumberTextCellRecord = TableNumberField<'value'>;
+export interface TableColumnNumberTextColumnConfig {
+    formatter: NumberFormatter;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'nimble-table-column-number-text': TableColumnNumberText;
+    }
+}
+/**
+ * The table column for displaying numbers as text.
+ */
+export declare class TableColumnNumberText extends TableColumnTextBase {
+    format: NumberTextFormat;
+    connectedCallback(): void;
+    protected getColumnInternalsOptions(): ColumnInternalsOptions;
+    private formatChanged;
+    private updateColumnConfig;
+    private createFormatter;
+}
+export declare const tableColumnNumberTextTag: string;

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

@@ -0,0 +1,60 @@
+import { __decorate } from "tslib";
+import { DesignSystem } from '@microsoft/fast-foundation';
+import { attr } from '@microsoft/fast-element';
+import { styles } from '../base/styles';
+import { template } from '../base/template';
+import { TableColumnTextBase } from '../text-base';
+import { TableColumnSortOperation } from '../base/types';
+import { tableColumnNumberTextGroupHeaderTag } from './group-header-view';
+import { tableColumnNumberTextCellViewTag } from './cell-view';
+import { NumberTextFormat } from './types';
+import { RoundToIntegerFormatter } from './models/round-to-integer-formatter';
+import { DefaultFormatter } from './models/default-formatter';
+/**
+ * The table column for displaying numbers as text.
+ */
+export class TableColumnNumberText extends TableColumnTextBase {
+    connectedCallback() {
+        super.connectedCallback();
+        this.updateColumnConfig();
+    }
+    getColumnInternalsOptions() {
+        return {
+            cellRecordFieldNames: ['value'],
+            cellViewTag: tableColumnNumberTextCellViewTag,
+            groupHeaderViewTag: tableColumnNumberTextGroupHeaderTag,
+            delegatedEvents: [],
+            sortOperation: TableColumnSortOperation.basic
+        };
+    }
+    formatChanged() {
+        this.updateColumnConfig();
+    }
+    updateColumnConfig() {
+        const columnConfig = {
+            formatter: this.createFormatter()
+        };
+        this.columnInternals.columnConfig = columnConfig;
+    }
+    createFormatter() {
+        switch (this.format) {
+            case NumberTextFormat.roundToInteger:
+                return new RoundToIntegerFormatter();
+            default:
+                return new DefaultFormatter();
+        }
+    }
+}
+__decorate([
+    attr
+], TableColumnNumberText.prototype, "format", void 0);
+const nimbleTableColumnNumberText = TableColumnNumberText.compose({
+    baseName: 'table-column-number-text',
+    template,
+    styles
+});
+DesignSystem.getOrCreate()
+    .withPrefix('nimble')
+    .register(nimbleTableColumnNumberText());
+export const tableColumnNumberTextTag = DesignSystem.tagFor(TableColumnNumberText);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/table-column/number-text/index.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,mCAAmC,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAa9D;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,mBAAmB;IAI1C,iBAAiB;QAC7B,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAEkB,yBAAyB;QACxC,OAAO;YACH,oBAAoB,EAAE,CAAC,OAAO,CAAC;YAC/B,WAAW,EAAE,gCAAgC;YAC7C,kBAAkB,EAAE,mCAAmC;YACvD,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,wBAAwB,CAAC,KAAK;SAChD,CAAC;IACN,CAAC;IAEO,aAAa;QACjB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAEO,kBAAkB;QACtB,MAAM,YAAY,GAAsC;YACpD,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,YAAY,CAAC;IACrD,CAAC;IAEO,eAAe;QACnB,QAAQ,IAAI,CAAC,MAAM,EAAE;YACjB,KAAK,gBAAgB,CAAC,cAAc;gBAChC,OAAO,IAAI,uBAAuB,EAAE,CAAC;YACzC;gBACI,OAAO,IAAI,gBAAgB,EAAE,CAAC;SACrC;IACL,CAAC;CACJ;AApCG;IADC,IAAI;qDAC2B;AAsCpC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC,OAAO,CAAC;IAC9D,QAAQ,EAAE,0BAA0B;IACpC,QAAQ;IACR,MAAM;CACT,CAAC,CAAC;AAEH,YAAY,CAAC,WAAW,EAAE;KACrB,UAAU,CAAC,QAAQ,CAAC;KACpB,QAAQ,CAAC,2BAA2B,EAAE,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC,MAAM,CACvD,qBAAqB,CACxB,CAAC"}

package/dist/esm/table-column/number-text/models/default-formatter.d.ts

@@ -0,0 +1,14 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'default'.
+ */
+export declare class DefaultFormatter extends NumberFormatter {
+    private static readonly maximumDigits;
+    private static readonly exponentialLowerBound;
+    private static readonly exponentialUpperBound;
+    private static readonly defaultFormatter;
+    private static readonly leadingZeroFormatter;
+    private static readonly exponentialFormatter;
+    protected format(number: number): string;
+    private getFormatterForNumber;
+}

package/dist/esm/table-column/number-text/models/default-formatter.js

@@ -0,0 +1,58 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'default'.
+ */
+export class DefaultFormatter extends NumberFormatter {
+    format(number) {
+        // The NumberFormat option of `signDisplay: "negative"` is not supported in all browsers nimble supports.
+        // Because that option cannot be used to avoid rendering "-0", coerce the value -0 to 0 prior to formatting.
+        const valueToFormat = number === 0 ? 0 : number;
+        const formatter = this.getFormatterForNumber(valueToFormat);
+        return formatter.format(valueToFormat);
+    }
+    getFormatterForNumber(number) {
+        if (number === 0) {
+            return DefaultFormatter.defaultFormatter;
+        }
+        const absoluteValue = Math.abs(number);
+        if (absoluteValue >= DefaultFormatter.exponentialUpperBound
+            || absoluteValue < DefaultFormatter.exponentialLowerBound) {
+            return DefaultFormatter.exponentialFormatter;
+        }
+        // Ideally, we could set 'roundingPriority: "lessPrecision"' with a formatter that has both 'maximumSignificantDigits' and
+        // 'maximumFractionDigits' configured instead of having two different formatters that we conditionally choose between. However,
+        // 'roundingPrioirty' is not supported yet in all browsers nimble supports.
+        if (absoluteValue < 1) {
+            return DefaultFormatter.leadingZeroFormatter;
+        }
+        return DefaultFormatter.defaultFormatter;
+    }
+}
+// The maximum number of digits that should be rendered for any given value.
+DefaultFormatter.maximumDigits = 6;
+// Use exponential notation for numbers that will be rendered with 3 leading 0s or more.
+// Because a maximum of 6 digits are rendered, showing more than 3 leading 0s is not ideal
+// because then at least half of the displayed digits will be leading 0s.
+DefaultFormatter.exponentialLowerBound = 0.000995;
+// Use exponential formatting for numbers whose magnitude cannot otherwise be displayed
+// with 6 digits or less.
+DefaultFormatter.exponentialUpperBound = 999999.5;
+// Formatter to use by default. It renders the number with a maximum of 6 signficant digits.
+DefaultFormatter.defaultFormatter = new Intl.NumberFormat(undefined, {
+    maximumSignificantDigits: DefaultFormatter.maximumDigits,
+    useGrouping: true
+});
+// Formatter to use for numbers that have leading zeros. It limits the number of rendered
+// digits using 'maximumFractionDigits', which will result in less than 6 significant digits
+// in order to render no more than 6 total digits.
+DefaultFormatter.leadingZeroFormatter = new Intl.NumberFormat(undefined, {
+    maximumFractionDigits: DefaultFormatter.maximumDigits - 1,
+    useGrouping: true
+});
+// Formatter for numbers that should be displayed in exponential notation. This should be used
+// for numbers with magintudes over 'exponentialUpperBound' or under 'exponentialLowerBound'.
+DefaultFormatter.exponentialFormatter = new Intl.NumberFormat(undefined, {
+    maximumSignificantDigits: DefaultFormatter.maximumDigits,
+    notation: 'scientific'
+});
+//# sourceMappingURL=default-formatter.js.map

package/dist/esm/table-column/number-text/models/default-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-formatter.js","sourceRoot":"","sources":["../../../../../src/table-column/number-text/models/default-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IA2CvC,MAAM,CAAC,MAAc;QAC3B,yGAAyG;QACzG,4GAA4G;QAC5G,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;QAC5D,OAAO,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAEO,qBAAqB,CAAC,MAAc;QACxC,IAAI,MAAM,KAAK,CAAC,EAAE;YACd,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;SAC5C;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IACI,aAAa,IAAI,gBAAgB,CAAC,qBAAqB;eACpD,aAAa,GAAG,gBAAgB,CAAC,qBAAqB,EAC3D;YACE,OAAO,gBAAgB,CAAC,oBAAoB,CAAC;SAChD;QACD,0HAA0H;QAC1H,+HAA+H;QAC/H,2EAA2E;QAC3E,IAAI,aAAa,GAAG,CAAC,EAAE;YACnB,OAAO,gBAAgB,CAAC,oBAAoB,CAAC;SAChD;QACD,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;IAC7C,CAAC;;AArED,4EAA4E;AACpD,8BAAa,GAAG,CAAC,CAAC;AAE1C,wFAAwF;AACxF,0FAA0F;AAC1F,yEAAyE;AACjD,sCAAqB,GAAG,QAAQ,CAAC;AAEzD,uFAAuF;AACvF,yBAAyB;AACD,sCAAqB,GAAG,QAAQ,CAAC;AAEzD,4FAA4F;AACpE,iCAAgB,GAAG,IAAI,IAAI,CAAC,YAAY,CAC5D,SAAS,EACT;IACI,wBAAwB,EAAE,gBAAgB,CAAC,aAAa;IACxD,WAAW,EAAE,IAAI;CACpB,CACJ,CAAC;AAEF,yFAAyF;AACzF,4FAA4F;AAC5F,kDAAkD;AAC1B,qCAAoB,GAAG,IAAI,IAAI,CAAC,YAAY,CAChE,SAAS,EACT;IACI,qBAAqB,EAAE,gBAAgB,CAAC,aAAa,GAAG,CAAC;IACzD,WAAW,EAAE,IAAI;CACpB,CACJ,CAAC;AAEF,8FAA8F;AAC9F,6FAA6F;AACrE,qCAAoB,GAAG,IAAI,IAAI,CAAC,YAAY,CAChE,SAAS,EACT;IACI,wBAAwB,EAAE,gBAAgB,CAAC,aAAa;IACxD,QAAQ,EAAE,YAAY;CACzB,CACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * The base class for number formatters used by the number-text column.
+ */
+export declare abstract class NumberFormatter {
+    /**
+     * Tries to format the passed value using the `format()` function implemented by a concrete implementation of the class.
+     * Returns an empty string if the value is not a number or if `format()` throws an error.
+     */
+    formatValue(value: number | undefined | null): string;
+    protected abstract format(number: number): string;
+}

package/dist/esm/table-column/number-text/models/number-formatter.js

@@ -0,0 +1,21 @@
+/**
+ * The base class for number formatters used by the number-text column.
+ */
+export class NumberFormatter {
+    /**
+     * Tries to format the passed value using the `format()` function implemented by a concrete implementation of the class.
+     * Returns an empty string if the value is not a number or if `format()` throws an error.
+     */
+    formatValue(value) {
+        if (typeof value !== 'number') {
+            return '';
+        }
+        try {
+            return this.format(value);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=number-formatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number-formatter.js","sourceRoot":"","sources":["../../../../../src/table-column/number-text/models/number-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAgB,eAAe;IACjC;;;OAGG;IACI,WAAW,CAAC,KAAgC;QAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC3B,OAAO,EAAE,CAAC;SACb;QAED,IAAI;YACA,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC7B;QAAC,MAAM;YACJ,OAAO,EAAE,CAAC;SACb;IACL,CAAC;CAGJ"}

package/dist/esm/table-column/number-text/models/round-to-integer-formatter.d.ts

@@ -0,0 +1,8 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'roundToInteger'.
+ */
+export declare class RoundToIntegerFormatter extends NumberFormatter {
+    private static readonly formatter;
+    protected format(number: number): string;
+}

package/dist/esm/table-column/number-text/models/round-to-integer-formatter.js

@@ -0,0 +1,18 @@
+import { NumberFormatter } from './number-formatter';
+/**
+ * The formatter for a number-text column whose format is configured to be 'roundToInteger'.
+ */
+export class RoundToIntegerFormatter extends NumberFormatter {
+    format(number) {
+        // The NumberFormat option of `signDisplay: "negative"` is not supported in all browsers nimble supports.
+        // Because that option cannot be used to avoid rendering "-0", coerce the values that will round to -0 to 0
+        // prior to formatting.
+        const valueToFormat = Math.round(number) === 0 ? 0 : number;
+        return RoundToIntegerFormatter.formatter.format(valueToFormat);
+    }
+}
+RoundToIntegerFormatter.formatter = new Intl.NumberFormat(undefined, {
+    maximumFractionDigits: 0,
+    useGrouping: true
+});
+//# sourceMappingURL=round-to-integer-formatter.js.map

package/dist/esm/table-column/number-text/models/round-to-integer-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-to-integer-formatter.js","sourceRoot":"","sources":["../../../../../src/table-column/number-text/models/round-to-integer-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAM9C,MAAM,CAAC,MAAc;QAC3B,yGAAyG;QACzG,2GAA2G;QAC3G,uBAAuB;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5D,OAAO,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC;;AAXuB,iCAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;IACjE,qBAAqB,EAAE,CAAC;IACxB,WAAW,EAAE,IAAI;CACpB,CAAC,CAAC"}

package/dist/esm/table-column/number-text/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Formatting scheme for the number-text table column
+ */
+export declare const NumberTextFormat: {
+    readonly default: undefined;
+    readonly roundToInteger: "round-to-integer";
+};
+export declare type NumberTextFormat = (typeof NumberTextFormat)[keyof typeof NumberTextFormat];

package/dist/esm/table-column/number-text/types.js

@@ -0,0 +1,8 @@
+/**
+ * Formatting scheme for the number-text table column
+ */
+export const NumberTextFormat = {
+    default: undefined,
+    roundToInteger: 'round-to-integer'
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/table-column/number-text/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/table-column/number-text/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,kBAAkB;CAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni/nimble-components",
-  "version": "20.1.9",
+  "version": "20.1.10",
   "description": "Styled web components for the NI Nimble Design System",
   "scripts": {
     "build": "npm run generate-icons && npm run build-components && npm run bundle-components && npm run generate-scss && npm run build-storybook",