@qrvey/utils 1.3.0-9 → 1.3.2

package/dist/cjs/filters/services/UChartPaginationApi.js

@@ -0,0 +1,295 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const isNumericalColumn_1 = require("../../columns/helpers/isNumericalColumn");
+const isDateColumn_1 = require("../../columns/helpers/isDateColumn");
+const OLD_getAggFilters_1 = require("../helpers/OLD_getAggFilters");
+const Charts_api_1 = __importDefault(require("../../services/api/Charts.api"));
+const isRangeValidator_1 = require("../helpers/common/isRangeValidator");
+const getUniqueArray_1 = require("../../general/array/getUniqueArray");
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const getAggFiltersBySummaryIndex_1 = require("../helpers/backend/getAggFiltersBySummaryIndex");
+const COLUMN_1 = require("../../columns/constants/COLUMN");
+const get_1 = require("../../general/object/get");
+const AGGREGATE_1 = require("../../charts/constants/AGGREGATE");
+const cloneDeep_1 = require("../../general/object/cloneDeep");
+const FILTER_VALIDATOR_1 = require("../constants/common/FILTER_VALIDATOR");
+const flatUIToOldLogic_1 = require("../adapters/flatUIToOldLogic");
+class UChartPaginationApi {
+    constructor() {
+        /**
+         * Gets afterKey object
+         * @returns the afterKey object
+         */
+        this.getAfterKey = () => {
+            return this.afterKey;
+        };
+        /**
+         * Gets a promise with a resulting data
+         * @param config the config
+         * @param uFilter The filter Builder filter
+         * @param filterLogic Additional filter logic to apply in the preview
+         * @param chartSettings The settings of the chart. For Aggregate Columns.
+         * @returns a promise with a resulting data
+         */
+        this.getChartResult = (config, uFilter, filterLogic = [], chartSettings, resetApi = false) => {
+            this.refineAfterkey(uFilter, resetApi);
+            this.setProps(uFilter);
+            const requestBody = this._getPreviewRequestBody(uFilter, filterLogic, chartSettings, this.afterKey);
+            const customChartApi = new Charts_api_1.default(Object.assign(Object.assign({}, config), { qrvey_id: (0, isEmpty_1.isEmpty)(uFilter.column.aggregate) ? uFilter.column.qrveyid : chartSettings === null || chartSettings === void 0 ? void 0 : chartSettings.qrveyid }));
+            return customChartApi.getResultsPagination(requestBody, false).then(response => {
+                return this._getDataFromResponse(response, uFilter);
+            }).catch(_ => {
+                return { data: [], total: 0 };
+            });
+        };
+        /**
+         * Gets request body structure
+         * @param uFilter The filter Builder filter
+         * @param filterLogic Additional filter logic to apply in the preview
+         * @param chartSettings The settings of the chart. For Aggregate Columns.
+         * @returns the request body structure
+         */
+        this._getPreviewRequestBody = (uFilter, filterLogic = [], chartSettings, afterKey) => {
+            const { column, validator } = uFilter;
+            const haveAggFilters = ((chartSettings === null || chartSettings === void 0 ? void 0 : chartSettings.aggregateColumns) || []).length && ((chartSettings === null || chartSettings === void 0 ? void 0 : chartSettings.chart) || []).length;
+            let searchLogic;
+            if (!(0, isEmpty_1.isEmpty)(uFilter.values)) {
+                searchLogic = (0, flatUIToOldLogic_1.flatUIToOldLogic)([Object.assign(Object.assign({}, uFilter), { validator: this._getValidationType(column, validator), column: Object.assign(Object.assign({}, uFilter.column), { linkid: undefined }) })]);
+            }
+            let filterCharts = [];
+            if (haveAggFilters) {
+                filterCharts = chartSettings === null || chartSettings === void 0 ? void 0 : chartSettings.chart.map(chart => {
+                    const summaryIndex = (chart.summaries || []).findIndex(s => s.questionid === uFilter.column.id && s.aggregate === uFilter.column.aggregate);
+                    const summary = summaryIndex !== -1 && chart.summaries[summaryIndex];
+                    const chartAggFilters = (0, getAggFiltersBySummaryIndex_1.getAggFiltersBySummaryIndex)(chart.aggFilters, summaryIndex);
+                    const searchAggFilters = (0, OLD_getAggFilters_1.getAggFilters)((searchLogic === null || searchLogic === void 0 ? void 0 : searchLogic.logic) || [], summary ? [summary] : []);
+                    return Object.assign(Object.assign({}, chart), { aggFilters: searchAggFilters || chartAggFilters, summaries: summary ? [summary] : [] });
+                }).filter(chart => chart.summaries.length);
+            }
+            const dimensions = !filterCharts[0] ? this._getDimensionsBody(uFilter) : this._getDimensionsBodyAdapter(filterCharts[0].dimensions);
+            const summaries = !filterCharts[0] ? this._getSummariesBody(uFilter) : filterCharts[0].summaries;
+            const maxDataPoints = this._getMaxDataPoints(column, chartSettings);
+            const filters = [
+                ...filterLogic,
+                ...!filterCharts[0] ? (searchLogic === null || searchLogic === void 0 ? void 0 : searchLogic.logic) || [] : []
+            ];
+            return { dimensions, summaries, maxDataPoints, afterKey, logic: filters };
+        };
+        /**
+         * Gets dimension body structure
+         * @param uFilter The filter Builder filter
+         * @returns the dimension body structure
+         */
+        this._getDimensionsBody = (uFilter) => {
+            const { column, validator } = uFilter;
+            let dimensions;
+            if (!(0, isRangeValidator_1.isRangeValidator)(validator)) {
+                dimensions = [{
+                        questionid: column.id,
+                        type: column.type,
+                        formulaType: column.type === COLUMN_1.COLUMN.FORMULA ? column.formulaType : undefined,
+                        sort: this._getSortOption(column)
+                    }];
+                dimensions = this._refineBodies([...dimensions], uFilter);
+            }
+            return dimensions;
+        };
+        /**
+         * Get a dimension body structure foor pagination endpoint
+         * @param dimensions
+         * @returns the dimension body structure
+         */
+        this._getDimensionsBodyAdapter = (dimensions = []) => {
+            return dimensions.map(dimension => ({
+                questionid: dimension.questionid,
+                type: dimension.type,
+                formulaType: dimension.type === COLUMN_1.COLUMN.FORMULA ? dimension.formulaType : undefined,
+                groupType: dimension.groupType,
+                groupValue: dimension.groupValue,
+                sort: {
+                    by: (0, get_1._get)(dimension, 'sortOption.sortBy', 'VALUE'),
+                    direction: (0, get_1._get)(dimension, 'sortOption.sortDirection', 'DESC'),
+                }
+            }));
+        };
+        /**
+         * Gets max data point number
+         * @param column The column to filter
+         * @param chartSettings The settings of the chart. For Aggregate Columns.
+         * @returns max data point number
+         */
+        this._getMaxDataPoints = (column, chartSettings) => {
+            return !(0, isDateColumn_1.isDateColumn)(column) && !(0, isEmpty_1.isEmpty)(column.aggregate) ? (0, get_1._get)(chartSettings, 'maxDataPoints.option', 1000) : 1000;
+        };
+        /**
+         * Gets sort option structure
+         * @param column The column to filter
+         * @returns sort option structure
+         */
+        this._getSortOption = (column) => {
+            let by = 'CATEGORY';
+            let direction = (0, isNumericalColumn_1.isNumericalColumn)(column) ? 'DESC' : 'ASC';
+            if (!(0, isEmpty_1.isEmpty)(column.sorting)) {
+                by = (0, get_1._get)(column.sorting, 'sortBy');
+                direction = (0, get_1._get)(column.sorting, 'order');
+                if (by == null)
+                    by = 'VALUE';
+                if (direction == null)
+                    direction = 'DESC';
+            }
+            return { by, direction };
+        };
+        /**
+         * Gets summaries body structure
+         * @param uFilter The filter Builder filter
+         * @returns summaries body structure
+         */
+        this._getSummariesBody = (uFilter) => {
+            const { column, validator } = uFilter;
+            const summary = {
+                aggregate: (0, get_1._get)(column, 'aggregate.label', AGGREGATE_1.AGGREGATE.COUNT),
+                questionid: column.id,
+                property: !(0, isDateColumn_1.isDateColumn)(uFilter.column) ? uFilter.property : undefined,
+                type: column.type
+            };
+            let summaries = [summary];
+            if ((0, isNumericalColumn_1.isNumericalColumn)(column) || (0, isRangeValidator_1.isRangeValidator)(validator)) {
+                summaries = [
+                    Object.assign(Object.assign({}, summary), { aggregate: AGGREGATE_1.AGGREGATE.MIN }),
+                    Object.assign(Object.assign({}, summary), { aggregate: AGGREGATE_1.AGGREGATE.MAX })
+                ];
+            }
+            return summaries;
+        };
+        /**
+         * Refines the body structure
+         * @param bodies The body structure
+         * @param uFilter The filter Builder filter
+         * @returns the body structure
+         */
+        this._refineBodies = (bodies, uFilter) => {
+            const _bodies = (0, cloneDeep_1.cloneDeep)(bodies);
+            if (uFilter.property != null) {
+                _bodies.forEach(body => {
+                    if ((0, isDateColumn_1.isDateColumn)(uFilter.column)) {
+                        body['groupType'] = 'DATE';
+                        body['groupValue'] = uFilter.property.toUpperCase();
+                    }
+                    else {
+                        body['property'] = uFilter.property;
+                    }
+                });
+            }
+            return _bodies;
+        };
+        /**
+         * Gets the validation type for the preview request
+         * @param column The column to filter
+         * @param vaildator Validator Type
+         * @returns the validator type for the preview request
+         */
+        this._getValidationType = (column, validator) => {
+            if ((0, isDateColumn_1.isDateColumn)(column) || column.type === COLUMN_1.COLUMN.BUCKET || (0, isNumericalColumn_1.isNumericalColumn)(column)) {
+                return FILTER_VALIDATOR_1.FILTER_VALIDATOR.EQUALS;
+            }
+            else {
+                if ([FILTER_VALIDATOR_1.FILTER_VALIDATOR.NOT_CONTAIN, FILTER_VALIDATOR_1.FILTER_VALIDATOR.EQUALS, FILTER_VALIDATOR_1.FILTER_VALIDATOR.NOT_EQUAL].includes(validator)) {
+                    return FILTER_VALIDATOR_1.FILTER_VALIDATOR.CONTAINS;
+                }
+                else if (validator === FILTER_VALIDATOR_1.FILTER_VALIDATOR.NOT_END_WITH) {
+                    return FILTER_VALIDATOR_1.FILTER_VALIDATOR.ENDS_WITH;
+                }
+                else if (validator === FILTER_VALIDATOR_1.FILTER_VALIDATOR.NOT_START_WITH) {
+                    return FILTER_VALIDATOR_1.FILTER_VALIDATOR.STARTS_WITH;
+                }
+                else {
+                    return validator;
+                }
+            }
+        };
+        /**
+         * Gets the Data from preview Response
+         * @param response The preview presponse
+         * @param uFilter The filter Builder filter
+         * @returns The resulting data
+         */
+        this._getDataFromResponse = (response, uFilter) => {
+            var _a;
+            const data = { data: [], total: 0 };
+            if (!this.isResultPaginationEmpty(response)) {
+                const records = (0, get_1._get)(response, 'data');
+                data.data = (0, isEmpty_1.isEmpty)(uFilter.column.aggregate)
+                    ? records.map(record => ({
+                        value: record.key.toString()
+                    }))
+                    : this._getResponseSummaries(records);
+                data.data = (0, getUniqueArray_1.getUniqueArray)(data.data, 'value');
+                data.total = (_a = (0, get_1._get)(response, 'totalGroups', 0)) !== null && _a !== void 0 ? _a : 0;
+                this.setAfterKey((0, get_1._get)(response, 'afterKey'));
+            }
+            return data;
+        };
+        /**
+         * Gets summaries from preview response
+         * @param records The data from preview response
+         * @param values The values from the preview response
+         * @returns the sumaries
+         */
+        this._getResponseSummaries = (records, values = []) => {
+            records.forEach(record => {
+                const value = record.summaries[0].toString();
+                value && values.push({ value });
+            });
+            return values;
+        };
+        /**
+         * Refines the afterKey object
+         * @param props
+         */
+        this.refineAfterkey = (uFilter, forceSet = false) => {
+            if (forceSet
+                || (0, get_1._get)(uFilter, 'values[0].value', '') !== (0, get_1._get)(this.uFilter, 'values[0].value', '')
+                || !this.areColumnsEquals(uFilter.column, (0, get_1._get)(this.uFilter, 'column'))
+                || uFilter.validator !== this.uFilter.validator
+                || uFilter.property !== this.uFilter.property
+                || uFilter.extras.scope !== this.uFilter.extras.scope)
+                this.setAfterKey(undefined);
+        };
+        /**
+         * Sets the afterKey object
+         * @param afterKey the afterKey object
+         */
+        this.setAfterKey = (afterKey) => {
+            this.afterKey = afterKey;
+        };
+        /**
+         * Sets the Filter Builder Filter
+         * @param uFilter
+         */
+        this.setProps = (uFilter) => {
+            this.uFilter = (0, cloneDeep_1.cloneDeep)(uFilter);
+        };
+        /**
+         * Checks if two filter columns are the same.
+         * @param column1
+         * @param column2
+         * @returns True: Columns are equal; False: Columns are not equal
+         */
+        this.areColumnsEquals = (column1, column2) => {
+            if ((0, isEmpty_1.isEmpty)(column1) || (0, isEmpty_1.isEmpty)(column2))
+                return false;
+            return column1.id === column2.id &&
+                column1.qrveyid === column2.qrveyid &&
+                column1.property === column2.property &&
+                column1.aggregate === column2.aggregate;
+        };
+        this.isResultPaginationEmpty = (resultObject) => {
+            const result = (0, get_1._get)(resultObject, 'data');
+            return (0, isEmpty_1.isEmpty)(result);
+        };
+    }
+}
+exports.default = UChartPaginationApi;

package/dist/cjs/filters/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from './Filters.api';
+export * from './UChartApi';
+export * from './UChartPaginationApi';

package/dist/cjs/filters/services/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Filters.api"), exports);
+__exportStar(require("./UChartApi"), exports);
+__exportStar(require("./UChartPaginationApi"), exports);

package/dist/cjs/format/definition.d.ts

@@ -42,3 +42,65 @@ export declare const DATETIME_OPTIONS: {
     minute: string;
     second: string;
 };
+export declare const PARTS_REGEX: RegExp;
+export declare const DURATION_PARTS: {
+    S: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    s: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    m: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    h: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    H: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    D: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    W: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    M: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+    Y: {
+        order: number;
+        symbol: string;
+        name: string;
+        ms: number;
+    };
+};
+export declare const DEFAULT_OPTIONS: {
+    unit: string;
+    locale: string;
+    fractionDigits: number;
+};

package/dist/cjs/format/definition.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DATETIME_OPTIONS = exports.CURRENCY_DEFAULT = exports.LANG_DEFAULT = exports.currencyISO = exports.isTextColumn = exports.supportNumericFormatting = exports.isNumericalColumn = exports.isComplexColumn = exports.hasfileSizeProperty = exports.appliesFormatting = exports.DATEGROUP_FORMATTING_UNSUPPORT = exports.QUESTION_FORMAT_SUPPORT = exports.numericalFields = exports.complexFields = exports.textFields = void 0;
+exports.DEFAULT_OPTIONS = exports.DURATION_PARTS = exports.PARTS_REGEX = exports.DATETIME_OPTIONS = exports.CURRENCY_DEFAULT = exports.LANG_DEFAULT = exports.currencyISO = exports.isTextColumn = exports.supportNumericFormatting = exports.isNumericalColumn = exports.isComplexColumn = exports.hasfileSizeProperty = exports.appliesFormatting = exports.DATEGROUP_FORMATTING_UNSUPPORT = exports.QUESTION_FORMAT_SUPPORT = exports.numericalFields = exports.complexFields = exports.textFields = void 0;
 const COLUMN_1 = require("../columns/constants/COLUMN");
 const Charts_Const_1 = require("../constants/Charts.Const");
 exports.textFields = [COLUMN_1.COLUMN.TEXTFIELD, COLUMN_1.COLUMN.TEXT_CATEGORY, COLUMN_1.COLUMN.TEXT_LABEL, COLUMN_1.COLUMN.TEXT_CATEGORY];
@@ -84,3 +84,20 @@ exports.currencyISO = [
 exports.LANG_DEFAULT = 'en-US';
 exports.CURRENCY_DEFAULT = { text: '$ (USD)', label: 'USD' };
 exports.DATETIME_OPTIONS = { year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric', second: 'numeric' };
+exports.PARTS_REGEX = /\[([^\]]+)]|Y{1,2}|M{1,2}|W{1,2}|D{1,2}|h{1,2}|H{1,2}|m{1,2}|s{1,2}|S{1,3}/g;
+exports.DURATION_PARTS = {
+    S: { order: 1, symbol: "S", name: "milliseconds", ms: 1 },
+    s: { order: 2, symbol: "s", name: "seconds", ms: 1000 },
+    m: { order: 3, symbol: "m", name: "minutes", ms: 1000 * 60 },
+    h: { order: 4, symbol: "h", name: "hours", ms: 1000 * 60 * 60 },
+    H: { order: 5, symbol: "H", name: "hours", ms: 1000 * 60 * 60 },
+    D: { order: 6, symbol: "D", name: "days", ms: 1000 * 60 * 60 * 24 },
+    W: { order: 7, symbol: "W", name: "weeks", ms: 1000 * 60 * 60 * 24 * 7 },
+    M: { order: 8, symbol: "M", name: "months", ms: 1000 * 60 * 60 * 24 * 30 },
+    Y: { order: 9, symbol: "Y", name: "years", ms: 1000 * 60 * 60 * 24 * 365 },
+};
+exports.DEFAULT_OPTIONS = {
+    unit: "seconds",
+    locale: "en-EN",
+    fractionDigits: 0
+};

package/dist/cjs/format/duration/addDurationFormat.d.ts

@@ -0,0 +1,13 @@
+/**[TODO: The decimals dots are not working correctly, we need to reviewing (fractionDigits)]
+ * "Convert a number of seconds to a human readable string."
+ *
+ * `addDurationFormat` is a function that takes a number, a format, an optional locale, and an optional
+ * number of fraction digits, and returns a string
+ * @param {number} number - The number of milliseconds to format.
+ * @param {string} format - The format string.
+ * @param {string} [locale] - The locale to use for formatting. If not specified, the default locale is
+ * used.
+ * @param {number} [fractionDigits] - The number of digits to show after the decimal point.
+ * @returns A string
+ */
+export declare function addDurationFormat(number: number, format: string, locale?: string, fractionDigits?: number): string;

package/dist/cjs/format/duration/addDurationFormat.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addDurationFormat = void 0;
+const durationFormatter_1 = require("./durationFormatter");
+/**[TODO: The decimals dots are not working correctly, we need to reviewing (fractionDigits)]
+ * "Convert a number of seconds to a human readable string."
+ *
+ * `addDurationFormat` is a function that takes a number, a format, an optional locale, and an optional
+ * number of fraction digits, and returns a string
+ * @param {number} number - The number of milliseconds to format.
+ * @param {string} format - The format string.
+ * @param {string} [locale] - The locale to use for formatting. If not specified, the default locale is
+ * used.
+ * @param {number} [fractionDigits] - The number of digits to show after the decimal point.
+ * @returns A string
+ */
+function addDurationFormat(number, format, locale, fractionDigits) {
+    return new durationFormatter_1.DurationFormatter({ template: format, options: { locale: locale, fractionDigits: fractionDigits } }).format(number);
+}
+exports.addDurationFormat = addDurationFormat;

package/dist/cjs/format/duration/durationFormatter.d.ts

@@ -0,0 +1,79 @@
+export declare class DurationFormatter {
+    private options;
+    private parts;
+    private valueFormatter;
+    private numberFactor;
+    private template;
+    private numberFormatOptions;
+    /**
+     * The constructor function takes in a template string and an options object. It then sets the
+     * options object to the default options object if no options object is passed in. It then parses
+     * the template string and sets the parts to the parsed template string. It then tries to set the
+     * valueFormatter to a new Intl.NumberFormat object with the locale and fractionDigits options. If
+     * it fails, it sets the valueFormatter to a new Intl.NumberFormat object with the default locale
+     * and fractionDigits options. It then sets the numberFactor to the duration parts object with the
+     * name of the unit option. If it can't find the unit option, it sets the numberFactor to 1
+     * @param [template] - The template string that will be used to format the duration.
+     * @param options - This is an object that contains the following properties: unit, locale and fractionDigits
+     */
+    constructor(options: {
+        template: string;
+        options?: {
+            unit?: string;
+            locale?: string;
+            fractionDigits?: number;
+        };
+        intlNumberFormat?: Intl.NumberFormat;
+    });
+    private setOptions;
+    /**
+     * It sets the locale formatter for the number.
+     */
+    private setLocaleFormatter;
+    /**
+     * It returns a new instance of the Intl.NumberFormat class, which is a built-in JavaScript class
+     * that formats numbers
+     * @param {string | string[]} locale - string | string[]
+     * @returns A new instance of the Intl.NumberFormat class.
+     */
+    private getNewNumberFormat;
+    /**
+     * It takes a template string and sets the parts property to the result of calling the
+     * parseFormatTemplate function with the template string as an argument
+     * @param {string} template - The format template string.
+     */
+    private setParts;
+    /**
+     * It replaces the H and D characters in the template with h and d respectively
+     * @param {string} template - The template string to be used for the date format.
+     * @returns The template string with all instances of H replaced with h and all instances of D
+     * replaced with d.
+     */
+    private matchFormatsReplace;
+    /**
+     * It sets the numberFactor to the value of the duration part that matches the unit.
+     */
+    private setNumberFactor;
+    /**
+     * It takes a string, splits it into an array of strings, then maps each string to a config object,
+     * then filters out any falsy values, then reverses the array
+     * @param {string} template - string - the template string that we want to parse
+     * @returns An array of objects that have the order and the name of the part of the duration.
+     */
+    private parseFormatTemplate;
+    /**
+     * It takes a number, multiplies it by a factor, then uses the parts array to calculate the number
+     * of each part in the number, then uses the template to format the number
+     * @param {number} number - The number of milliseconds to format.
+     * @returns The template string with the values replaced.
+     */
+    format(number: number): string;
+    /**
+     * It takes a dictionary of values and a list of keys, and returns a formatted string
+     * @param parts - { [x: string]: any; }
+     * @param {string | (string | number)[]} part - This is the part of the date that we're
+     * formatting.
+     * @returns The value of the part of the date that is being formatted.
+     */
+    private formatValue;
+}