@perses-dev/components 0.55.0-beta.2 → 0.55.0-beta.6

package/dist/cjs/utils/combine-sx.js

@@ -1,31 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "combineSx", {
-    enumerable: true,
-    get: function() {
-        return combineSx;
-    }
-});
-function combineSx(...sxProps) {
-    return sxProps.flatMap((sx)=>{
-        if (sx === undefined) return [];
-        if (Array.isArray(sx)) return sx;
-        return [
-            sx
-        ];
-    });
-}

package/dist/cjs/utils/component-ids.js

@@ -1,33 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "useId", {
-    enumerable: true,
-    get: function() {
-        return useId;
-    }
-});
-const _react = require("react");
-function useId(prefix) {
-    if (globalThis.useIdValue === undefined) {
-        globalThis.useIdValue = 0;
-    }
-    const id = (0, _react.useRef)(undefined);
-    if (id.current === undefined) {
-        id.current = `${prefix}-${globalThis.useIdValue++}`;
-    }
-    return id.current;
-}

package/dist/cjs/utils/data-field-interpolation.js

@@ -1,230 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get extractFieldNames () {
-        return extractFieldNames;
-    },
-    get hasBatchPatterns () {
-        return hasBatchPatterns;
-    },
-    get hasDataFieldPatterns () {
-        return hasDataFieldPatterns;
-    },
-    get hasIndexedPatterns () {
-        return hasIndexedPatterns;
-    },
-    get parseFormat () {
-        return parseFormat;
-    },
-    get replaceDataFields () {
-        return replaceDataFields;
-    },
-    get replaceDataFieldsBatch () {
-        return replaceDataFieldsBatch;
-    }
-});
-const _variableinterpolation = require("./variable-interpolation");
-// Regex patterns for data field interpolation
-// Matches: ${__data.fields["fieldName"]} or ${__data.fields['fieldName']} or ${__data.fields.fieldName} with optional format ${__data.fields["fieldName"]:format}
-const SINGLE_FIELD_REGEX = /\$\{__data\.fields(?:\[(?:"|')([^"']+)(?:"|')\]|\.([a-zA-Z_][a-zA-Z0-9_]*))(?::([a-z]+))?\}/g;
-// Matches: ${__data[0].fields["fieldName"]} or ${__data[0].fields['fieldName']} for indexed access
-const INDEXED_FIELD_REGEX = /\$\{__data\[(\d+)\]\.fields\[(?:"|')([^"']+)(?:"|')\]\}/g;
-// Matches: ${__data.index}
-const DATA_INDEX_REGEX = /\$\{__data\.index\}/g;
-// Matches: ${__data.count}
-const DATA_COUNT_REGEX = /\$\{__data\.count\}/g;
-// Matches: ${__data} or ${__data:format} or '${__data:format}' or "${__data:format}"
-const FULL_DATA_REGEX = /("|')?\$\{__data(?::([a-z]+))?\}("|')?/g;
-/**
- * Get field value from a data item, converting to string.
- * Supports nested field access using dot notation in field names (e.g., "foo.bar" accesses item.foo.bar).
- * For backward compatibility, first checks if the exact key exists before attempting nested access.
- */ function getFieldValue(item, fieldName) {
-    // First, try direct property access (for backward compatibility with literal dot keys)
-    if (Object.prototype.hasOwnProperty.call(item, fieldName)) {
-        const value = item[fieldName];
-        if (value === undefined || value === null) {
-            return '';
-        }
-        if (typeof value === 'object') {
-            return JSON.stringify(value);
-        }
-        return String(value);
-    }
-    // If not found and contains dots, try nested access
-    if (fieldName.includes('.')) {
-        const parts = fieldName.split('.');
-        let current = item;
-        for (const part of parts){
-            if (current === null || current === undefined) {
-                return '';
-            }
-            if (typeof current !== 'object') {
-                return '';
-            }
-            current = current[part];
-        }
-        if (current === undefined || current === null) {
-            return '';
-        }
-        if (typeof current === 'object') {
-            return JSON.stringify(current);
-        }
-        return String(current);
-    }
-    // Field not found
-    return '';
-}
-function parseFormat(format) {
-    if (!format) return undefined;
-    const lowerFormat = format.toLowerCase();
-    return Object.values(_variableinterpolation.InterpolationFormat).find((f)=>f === lowerFormat);
-}
-function replaceDataFields(template, item, options = {}) {
-    const { urlEncode = true, index, count } = options;
-    let result = template;
-    const errors = [];
-    // Replace ${__data.index} if provided
-    if (index !== undefined) {
-        result = result.replaceAll(DATA_INDEX_REGEX, String(index));
-    }
-    // Replace ${__data.count} if provided
-    if (count !== undefined) {
-        result = result.replaceAll(DATA_COUNT_REGEX, String(count));
-    }
-    // Replace full data placeholder with optional format: ${__data} or ${__data:format}
-    result = result.replaceAll(FULL_DATA_REGEX, (_match, _leadingQuote, format, _trailingQuote)=>{
-        const interpolationFormat = parseFormat(format) ?? _variableinterpolation.InterpolationFormat.RAW;
-        let interpolationResult = '';
-        if (interpolationFormat === _variableinterpolation.InterpolationFormat.JSON) {
-            interpolationResult = JSON.stringify(item);
-        } else {
-            interpolationResult = (0, _variableinterpolation.interpolate)(Object.values(item).map((v)=>JSON.stringify(v)), '', interpolationFormat);
-        }
-        return interpolationResult;
-    });
-    // Reset regex lastIndex
-    SINGLE_FIELD_REGEX.lastIndex = 0;
-    // Replace __data.fields["fieldName"] or __data.fields.fieldName patterns
-    result = result.replaceAll(SINGLE_FIELD_REGEX, (_match, bracketField, dotField, format)=>{
-        const fieldName = bracketField ?? dotField ?? '';
-        const value = getFieldValue(item, fieldName);
-        if (value === '' && item[fieldName] === undefined) {
-            errors.push(`Field "${fieldName}" not found in data`);
-        }
-        const interpolationFormat = parseFormat(format);
-        if (interpolationFormat) {
-            return (0, _variableinterpolation.interpolate)([
-                value
-            ], fieldName, interpolationFormat);
-        }
-        if (urlEncode) {
-            // override: disable urlEncode for RAW format
-            if (interpolationFormat === _variableinterpolation.InterpolationFormat.RAW) {
-                return value;
-            }
-            // avoid double encoding for queryparam and percentencode formats
-            if (interpolationFormat !== _variableinterpolation.InterpolationFormat.QUERYPARAM && interpolationFormat !== _variableinterpolation.InterpolationFormat.PERCENTENCODE) {
-                return encodeURIComponent(value);
-            }
-        }
-        return value;
-    });
-    return {
-        text: result,
-        errors: errors.length > 0 ? errors : undefined
-    };
-}
-function replaceDataFieldsBatch(template, items, options = {}) {
-    const { urlEncode = true } = options;
-    let result = template;
-    const errors = [];
-    // Replace __data.count with items length
-    result = result.replaceAll(DATA_COUNT_REGEX, String(items.length));
-    // Reset regex lastIndex
-    INDEXED_FIELD_REGEX.lastIndex = 0;
-    SINGLE_FIELD_REGEX.lastIndex = 0;
-    // Replace full data placeholder with optional format
-    result = result.replaceAll(FULL_DATA_REGEX, (_match, leadingQuote, format, trailingQuote)=>{
-        const interpolationFormat = parseFormat(format) ?? _variableinterpolation.InterpolationFormat.RAW;
-        const interpolationResult = (0, _variableinterpolation.interpolate)(Object.values(items).map((e)=>JSON.stringify(e)), '', interpolationFormat);
-        if (!leadingQuote || !trailingQuote) {
-            // preserve quotes as they were not surrounding the full_data pattern
-            return `${leadingQuote ?? ''}${interpolationResult}${trailingQuote ?? ''}`;
-        }
-        return interpolationResult;
-    });
-    // Replace indexed access: ${__data[0].fields["fieldName"]} or ${__data[0].fields['fieldName']}
-    result = result.replaceAll(INDEXED_FIELD_REGEX, (match, indexStr, fieldName)=>{
-        const idx = parseInt(indexStr, 10);
-        if (idx < 0 || idx >= items.length) {
-            errors.push(`Index ${idx} out of bounds (0-${items.length - 1})`);
-            return match;
-        }
-        const value = getFieldValue(items[idx], fieldName);
-        if (value === '' && items[idx][fieldName] === undefined) {
-            errors.push(`Field "${fieldName}" not found in data at index ${idx}`);
-        }
-        return urlEncode ? encodeURIComponent(value) : value;
-    });
-    // Replace aggregated access with format: ${__data.fields["fieldName"]:csv} or ${__data.fields.fieldName:csv}
-    result = result.replaceAll(SINGLE_FIELD_REGEX, (_match, bracketField, dotField, format)=>{
-        const fieldName = bracketField ?? dotField ?? '';
-        const values = items.map((item)=>getFieldValue(item, fieldName));
-        const interpolationFormat = parseFormat(format) || _variableinterpolation.InterpolationFormat.CSV;
-        return (0, _variableinterpolation.interpolate)(values, fieldName, interpolationFormat);
-    });
-    return {
-        text: result,
-        errors: errors.length > 0 ? errors : undefined
-    };
-}
-function hasBatchPatterns(template) {
-    // Reset regex lastIndex
-    INDEXED_FIELD_REGEX.lastIndex = 0;
-    return INDEXED_FIELD_REGEX.test(template) || /\$\{__data\.fields(?:\[["'][^"']+["']\]|\.[a-zA-Z_][a-zA-Z0-9_]*):[a-z]+\}/.test(template);
-}
-function hasIndexedPatterns(template) {
-    INDEXED_FIELD_REGEX.lastIndex = 0;
-    return INDEXED_FIELD_REGEX.test(template);
-}
-function hasDataFieldPatterns(template) {
-    SINGLE_FIELD_REGEX.lastIndex = 0;
-    INDEXED_FIELD_REGEX.lastIndex = 0;
-    return SINGLE_FIELD_REGEX.test(template) || INDEXED_FIELD_REGEX.test(template);
-}
-function extractFieldNames(template) {
-    const fields = new Set();
-    // Reset regex lastIndex
-    SINGLE_FIELD_REGEX.lastIndex = 0;
-    INDEXED_FIELD_REGEX.lastIndex = 0;
-    let match;
-    while((match = SINGLE_FIELD_REGEX.exec(template)) !== null){
-        // Group 1 is bracket notation, group 2 is dot notation
-        fields.add(match[1] ?? match[2]);
-    }
-    while((match = INDEXED_FIELD_REGEX.exec(template)) !== null){
-        fields.add(match[2]);
-    }
-    return Array.from(fields);
-}

package/dist/cjs/utils/format.js

@@ -1,127 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get dateFormatOptionsWithTimeZone () {
-        return dateFormatOptionsWithTimeZone;
-    },
-    get formatWithTimeZone () {
-        return formatWithTimeZone;
-    },
-    get getDateAndTime () {
-        return getDateAndTime;
-    },
-    get getFormattedAxisLabel () {
-        return getFormattedAxisLabel;
-    },
-    get getGMTOffset () {
-        return getGMTOffset;
-    }
-});
-const _tz = require("@date-fns/tz");
-const _datefns = require("date-fns");
-function dateFormatOptionsWithTimeZone(dateFormatOptions, timeZone) {
-    /*
-   * if timeZone is provided, and is not local|browser,
-   * then set timeZone option (recognize UTC regardless of uppercase/lowercase)
-   * otherwise, default to browser timeZone setting
-   */ if (timeZone) {
-        const lowerTimeZone = timeZone.toLowerCase();
-        if (lowerTimeZone !== 'local' && lowerTimeZone !== 'browser') {
-            return {
-                ...dateFormatOptions,
-                timeZone: lowerTimeZone === 'utc' ? 'UTC' : timeZone
-            };
-        }
-    }
-    return dateFormatOptions;
-}
-function formatWithTimeZone(date, formatString, timeZone) {
-    /*
-   * if timeZone is provided, and is not local|browser,
-   * then format using timeZone option (recognize UTC regardless of uppercase/lowercase)
-   * otherwise, format without timeZone option, defaulting to browser timeZone setting
-   */ const lowerTimeZone = timeZone?.toLowerCase();
-    if (!timeZone || lowerTimeZone === 'local' || lowerTimeZone === 'browser') {
-        return (0, _datefns.format)(date, formatString);
-    } else {
-        return (0, _datefns.format)(date, formatString, {
-            in: (0, _tz.tz)(lowerTimeZone === 'utc' ? 'UTC' : timeZone)
-        });
-    }
-}
-function getGMTOffset(timeZone) {
-    const lower = timeZone?.toLowerCase();
-    const resolvedTimeZone = !timeZone || lower === 'local' || lower === 'browser' ? Intl.DateTimeFormat().resolvedOptions().timeZone : lower === 'utc' ? 'UTC' : timeZone;
-    try {
-        const formatter = new Intl.DateTimeFormat('en-US', {
-            timeZone: resolvedTimeZone,
-            timeZoneName: 'shortOffset'
-        });
-        const parts = formatter.formatToParts(new Date());
-        const tzPart = parts.find((p)=>p.type === 'timeZoneName');
-        const value = tzPart?.value ?? '';
-        if (value === 'GMT') return 'GMT+0';
-        return value;
-    } catch  {
-        return 'GMT+0';
-    }
-}
-function getFormattedAxisLabel(rangeMs) {
-    const dayMs = 86400000;
-    const monthMs = 2629440000;
-    const yearMs = 31536000000;
-    // more than 5 years
-    if (rangeMs > yearMs * 5) {
-        return '{yyyy}';
-    }
-    // more than 2 years
-    if (rangeMs > yearMs * 2) {
-        return '{MMM} {yyyy}';
-    }
-    // between 5 days to 6 months
-    if (rangeMs > dayMs * 5 && rangeMs < monthMs * 6) {
-        return '{MM}/{dd}'; // 12/01
-    }
-    // between 2 and 5 days
-    if (rangeMs > dayMs * 2 && rangeMs <= dayMs * 5) {
-        return '{MM}/{dd} {HH}:{mm}'; // 12/01 12:30
-    }
-    return {
-        year: '{yearStyle|{yyyy}}\n{monthStyle|{MMM}}',
-        month: '{MMM}',
-        day: '{MM}/{dd}'
-    };
-}
-const getDateAndTime = (timeMs, customFormat)=>{
-    if (!timeMs) {
-        return {
-            formattedDate: '',
-            formattedTime: ''
-        };
-    }
-    const date = new Date(timeMs);
-    return {
-        formattedDate: customFormat ? customFormat(date, 'MMM dd, yyyy') : (0, _datefns.format)(date, 'MMM dd, yyyy'),
-        formattedTime: customFormat ? customFormat(date, 'HH:mm:ss') : (0, _datefns.format)(date, 'HH:mm:ss')
-    };
-};

package/dist/cjs/utils/index.js

@@ -1,48 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./axis"), exports);
-_export_star(require("./browser-storage"), exports);
-_export_star(require("./chart-actions"), exports);
-_export_star(require("./combine-sx"), exports);
-_export_star(require("./component-ids"), exports);
-_export_star(require("./data-field-interpolation"), exports);
-_export_star(require("./format"), exports);
-_export_star(require("./memo"), exports);
-_export_star(require("./request-interpolation"), exports);
-_export_star(require("./selection-interpolation"), exports);
-_export_star(require("./theme-gen"), exports);
-_export_star(require("./variable-interpolation"), exports);
-_export_star(require("./value-mapping"), exports);
-_export_star(require("./regexp"), exports);
-_export_star(require("./transform-data"), exports);
-_export_star(require("./time-series-data"), exports);
-_export_star(require("./trace-data"), exports);
-_export_star(require("./types"), exports);
-_export_star(require("./text"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/dist/cjs/utils/mathjs.js

@@ -1,38 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get gcd () {
-        return gcd;
-    },
-    get round () {
-        return round;
-    }
-});
-const _mathjs = require("mathjs");
-// This ensures we get a minimal mathjs bundle for just what we need (see https://mathjs.org/docs/custom_bundling.html)
-const { round } = (0, _mathjs.create)({
-    roundDependencies: _mathjs.roundDependencies
-});
-const { gcd } = (0, _mathjs.create)({
-    gcdDependencies: _mathjs.gcdDependencies
-});

package/dist/cjs/utils/memo.js

@@ -1,64 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get useDeepMemo () {
-        return useDeepMemo;
-    },
-    get useMemoized () {
-        return useMemoized;
-    }
-});
-const _react = require("react");
-const _isEqual = /*#__PURE__*/ _interop_require_default(require("lodash/isEqual"));
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-function useMemoized(factory, deps) {
-    const ref = (0, _react.useRef)();
-    let areEqual = true;
-    for(let i = 0; i < deps.length; i++){
-        if (ref.current?.deps[i] !== deps[i]) {
-            areEqual = false;
-            break;
-        }
-    }
-    if (ref.current === undefined || areEqual === false) {
-        ref.current = {
-            value: factory(),
-            deps: deps
-        };
-    }
-    return ref.current.value;
-}
-function useDeepMemo(factory, deps) {
-    const ref = (0, _react.useRef)();
-    if (ref.current === undefined || (0, _isEqual.default)(deps, ref.current.deps) === false) {
-        ref.current = {
-            value: factory(),
-            deps
-        };
-    }
-    return ref.current.value;
-}

package/dist/cjs/utils/regexp.js

@@ -1,54 +0,0 @@
-// Copyright The Perses Authors
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-/**
- * Checks if a string is a regex pattern.
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get createRegexFromString () {
-        return createRegexFromString;
-    },
-    get isRegexPattern () {
-        return isRegexPattern;
-    }
-});
-function isRegexPattern(input) {
-    return Boolean(input?.startsWith('/'));
-}
-function createRegexFromString(input) {
-    if (!input) {
-        throw new Error('Input string cannot be empty');
-    }
-    if (!isRegexPattern(input)) {
-        return new RegExp(`^${input}$`);
-    }
-    const regexPattern = /^\/(.+)\/([gimy]*)$/;
-    const matches = input.match(regexPattern);
-    if (!matches) {
-        throw new Error(`Invalid regular expression format: ${input}`);
-    }
-    const [, pattern = '', flags = ''] = matches;
-    try {
-        return new RegExp(pattern, flags);
-    } catch (error) {
-        throw new Error(`Failed to create RegExp ${error}`);
-    }
-}