jodit-pro 4.9.21 → 4.9.22

package/es2021.en/jodit.js

@@ -1,7 +1,7 @@
 /*!
  * jodit-pro - PRO Version of Jodit Editor
  * Author: Chupurnov Valerii <chupurnov@gmail.com>
- * Version: v4.9.21
+ * Version: v4.9.22
  * Url: https://xdsoft.net/jodit/pro/
  * License(s): SEE LICENSE IN LICENSE.md
  */
@@ -4622,7 +4622,96 @@ function removeExtraTags(elm) {
 
 let ConfigPrototype = {};
 /**
- * Default Editor's Configuration
+ * Default Editor's Configuration.
+ *
+ * This class holds all default option values for the Jodit editor.
+ * It uses a **private constructor** and a **lazy singleton** pattern — the single instance
+ * is created on the first access to {@link Config.defaultOptions} (also available as `Jodit.defaultOptions`).
+ *
+ * ## How options are resolved
+ *
+ * When you create an editor with `Jodit.make('#editor', userOptions)`, the library
+ * calls {@link ConfigProto}(userOptions, Config.defaultOptions). `ConfigProto` does
+ * **not** deep-clone the defaults. Instead it creates a new object whose JavaScript
+ * prototype is `Config.defaultOptions`:
+ *
+ * ```
+ * userOptions  ──[[Prototype]]──►  Config.defaultOptions
+ * ```
+ *
+ * Any key present in `userOptions` shadows the default;
+ * any key **not** present falls through to `Config.defaultOptions` via the prototype chain.
+ * Nested plain objects are recursively prototyped in the same way, so partial overrides
+ * of nested options work automatically:
+ *
+ * ```js
+ * // Only override `dialogWidth`; all other `image.*` defaults are still available
+ * Jodit.make('#editor', {
+ *   image: { dialogWidth: 500 }
+ * });
+ * ```
+ *
+ * ## How plugins extend the config
+ *
+ * Each plugin adds its own defaults by assigning to `Config.prototype` and augmenting
+ * the TypeScript type with `declare module`:
+ *
+ * ```ts
+ * // 1. Type augmentation (compile-time)
+ * declare module 'jodit/config' {
+ *   interface Config {
+ *     toolbarSticky: boolean;
+ *   }
+ * }
+ *
+ * // 2. Runtime default
+ * Config.prototype.toolbarSticky = true;
+ * ```
+ *
+ * Because the constructor runs `Object.assign(this, ConfigPrototype)` (where
+ * `ConfigPrototype` is captured as `Config.prototype` after the class definition),
+ * all prototype-level values — including those added by plugins — are materialized
+ * as own properties on the singleton. This means `Config.defaultOptions` always
+ * contains every registered option as an own, enumerable property.
+ *
+ * ## Changing global defaults
+ *
+ * You can modify `Jodit.defaultOptions` **before** creating editors to change
+ * defaults globally:
+ *
+ * ```js
+ * Jodit.defaultOptions.language = 'de';
+ * Jodit.defaultOptions.theme = 'dark';
+ *
+ * // Both editors inherit the new defaults
+ * Jodit.make('#editor1');
+ * Jodit.make('#editor2');
+ * ```
+ *
+ * ## `Jodit.atom` — preventing deep merge
+ *
+ * By default, `ConfigProto` deep-merges nested plain objects and arrays.
+ * Wrap a value with `Jodit.atom(value)` to make it **atomic** — it will completely
+ * replace the default instead of being merged:
+ *
+ * ```js
+ * Jodit.make('#editor', {
+ *   controls: {
+ *     fontsize: {
+ *       // Replace the entire list rather than merging with the default one
+ *       list: Jodit.atom([8, 9, 10])
+ *     }
+ *   }
+ * });
+ * ```
+ *
+ * `Jodit.atom` calls {@link markAsAtomic}, which sets a non-enumerable
+ * `isAtom` flag on the object. `ConfigProto` checks this flag and skips
+ * recursive merging when it is present. Note: top-level arrays (depth 0)
+ * are always treated as atomic — they replace rather than merge.
+ *
+ * @see {@link ConfigProto} for the full merge algorithm
+ * @see {@link markAsAtomic} / {@link isAtom} for the atom marker implementation
  */ class Config {
     static get defaultOptions() {
         if (!Config.__defaultOptions) {
@@ -4632,31 +4721,32 @@ let ConfigPrototype = {};
     }
     constructor(){
         /**
-         * Use cache for heavy methods
+         * When enabled, the editor caches the results of expensive computations (e.g. toolbar rebuilds)
+         * to improve performance. Disable for debugging or when options change frequently at runtime.
          */ this.cache = true;
         /**
          * Timeout of all asynchronous methods
          */ this.defaultTimeout = 100;
-        this.namespace = '';
+        /**
+         * Prefix used for CSS class names and local-storage keys to avoid collisions
+         * when multiple editor instances or applications share the same page.
+         */ this.namespace = '';
         /**
          * Editor loads completely without plugins. Useful when debugging your own plugin.
          */ this.safeMode = false;
         /**
          * Editor's width
          *
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    width: '100%',
          * })
          * ```
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    width: 600, // equivalent for '600px'
          * })
          * ```
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    width: 'auto', // autosize
@@ -4666,19 +4756,16 @@ let ConfigPrototype = {};
         /**
          * Editor's height
          *
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    height: '100%',
          * })
          * ```
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    height: 600, // equivalent for '600px'
          * })
          * ```
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    height: 'auto', // default - autosize
@@ -4715,7 +4802,32 @@ let ConfigPrototype = {};
          * });
          * ```
          */ this.preset = 'custom';
-        this.presets = {
+        /**
+         * Dictionary of named configuration presets. Each key is a preset name and the value
+         * is a partial options object that will be merged into the editor config when
+         * {@link Config.preset} matches the key.
+         *
+         * ```javascript
+         * // Use a built-in preset
+         * Jodit.make('#editor', {
+         *     preset: 'inline'
+         * });
+         * ```
+         *
+         * ```javascript
+         * // Define and use a custom preset
+         * Jodit.defaultOptions.presets.myCompact = {
+         *     toolbarButtonSize: 'small',
+         *     showCharsCounter: false,
+         *     showWordsCounter: false,
+         *     showXPathInStatusbar: false
+         * };
+         *
+         * Jodit.make('#editor', {
+         *     preset: 'myCompact'
+         * });
+         * ```
+         */ this.presets = {
             inline: {
                 inline: true,
                 toolbar: false,
@@ -4727,7 +4839,10 @@ let ConfigPrototype = {};
                 showPlaceholder: false
             }
         };
-        this.ownerDocument = _core_constants_js__WEBPACK_IMPORTED_MODULE_0__.globalDocument;
+        /**
+         * The Document object the editor operates within. Defaults to the current `document`.
+         * Override when the editor is created inside an iframe or a different browsing context.
+         */ this.ownerDocument = _core_constants_js__WEBPACK_IMPORTED_MODULE_0__.globalDocument;
         /**
          * Allows you to specify the window in which the editor will be created. Default - window
          * This is necessary if you are creating the editor inside an iframe but the code is running in the parent window
@@ -4758,7 +4873,9 @@ let ConfigPrototype = {};
          * ```
          */ this.shadowRoot = null;
         /**
-         * z-index For editor
+         * Base CSS `z-index` for the editor UI (toolbar, popups, dialogs).
+         * Set to a higher value when other page elements overlap the editor.
+         * `0` means no explicit z-index is applied.
          */ this.zIndex = 0;
         /**
          * Change the read-only state of the editor
@@ -4794,7 +4911,6 @@ let ConfigPrototype = {};
         /**
          * Size of icons in the toolbar (can be "small", "middle", "large")
          *
-         * @example
          * ```javascript
          * const editor = Jodit.make(".dark_editor", {
          *      toolbarButtonSize: "small"
@@ -4805,11 +4921,13 @@ let ConfigPrototype = {};
          * Allow navigation in the toolbar of the editor by Tab key
          */ this.allowTabNavigation = false;
         /**
-         * Inline editing mode
+         * When enabled, the editor renders without its own container chrome (toolbar, borders, statusbar).
+         * The editable area becomes the element itself. Typically combined with
+         * `toolbarInline: true` so a floating toolbar appears on selection.
          */ this.inline = false;
         /**
          * Theme (can be "dark")
-         * @example
+         *
          * ```javascript
          * const editor = Jodit.make(".dark_editor", {
          *      theme: "dark"
@@ -4822,10 +4940,9 @@ let ConfigPrototype = {};
         /**
          * Class name that can be appended to the editable area
          *
-         * @see [[Config.iframeCSSLinks]]
-         * @see [[Config.iframeStyle]]
+         * @see {@link Config.iframeCSSLinks}
+         * @see {@link Config.iframeStyle}
          *
-         * @example
          * ```javascript
          * Jodit.make('#editor', {
          *    editorClassName: 'some_my_class'
@@ -4841,7 +4958,7 @@ let ConfigPrototype = {};
          */ this.editorClassName = false;
         /**
          * Class name that can be appended to the main editor container
-         * @example
+         *
          * ```javascript
          * const jodit = Jodit.make('#editor', {
          *    className: 'some_my_class'
@@ -4861,7 +4978,7 @@ let ConfigPrototype = {};
         /**
          * The internal styles of the editable area. They are intended to change
          * not the appearance of the editor, but to change the appearance of the content.
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor', {
          * 		style: {
@@ -4872,13 +4989,14 @@ let ConfigPrototype = {};
          * ```
          */ this.style = false;
         /**
+         * Inline CSS styles applied to the outer editor container element.
+         * Use this to style the editor wrapper (borders, background, etc.) without affecting content.
          *
-         * @example
          * ```javascript
          * Jodit.make('#editor', {
-         * 		editorStyle: {
-         * 		 font: '12px Arial',
-         * 		 color: '#0c0c0c'
+         * 		containerStyle: {
+         * 		 border: '1px solid #ccc',
+         * 		 background: '#f9f9f9'
          * 		}
          * });
          * ```
@@ -4887,7 +5005,6 @@ let ConfigPrototype = {};
          * Dictionary of variable values in css, a complete list can be found here
          * https://github.com/xdan/jodit/blob/main/src/styles/variables.less#L25
          *
-         * @example
          * ```js
          * const editor = Jodit.make('#editor', {
          *   styleValues: {
@@ -4899,9 +5016,9 @@ let ConfigPrototype = {};
          * ```
          */ this.styleValues = {};
         /**
-         * After all, changes in editors for textarea will call change trigger
+         * When enabled, the editor dispatches a native `change` event on the original
+         * `<textarea>` element whenever the content changes, so standard DOM listeners work.
          *
-         * @example
          * ```javascript
          * const editor = Jodit.make('#editor');
          * document.getElementById('editor').addEventListener('change', function () {
@@ -4915,7 +5032,6 @@ let ConfigPrototype = {};
          * the page element direction. 'ltr' – Indicates a Left-To-Right text direction (like in English).
          * 'rtl' – Indicates a Right-To-Left text direction (like in Arabic).
          *
-         * @example
          * ```javascript
          * Jodit.make('.editor', {
          *    direction: 'rtl'
@@ -4927,7 +5043,6 @@ let ConfigPrototype = {};
          * (navigator.language && navigator.language.substr(0, 2)) ||
          * (navigator.browserLanguage && navigator.browserLanguage.substr(0, 2)) || 'en'
          *
-         * @example
          * ```html
          * <!-- include in you page lang file -->
          * <script src="jodit/lang/de.js"></script>
@@ -4941,7 +5056,6 @@ let ConfigPrototype = {};
         /**
          * if true all Lang.i18n(key) return `{key}`
          *
-         * @example
          * ```html
          * <script>
          * var editor = Jodit.make('.editor', {
@@ -4955,7 +5069,6 @@ let ConfigPrototype = {};
         /**
          * Collection of language pack data `{en: {'Type something': 'Type something', ...}}`
          *
-         * @example
          * ```javascript
          * const editor = Jodit.make('#editor', {
          *     language: 'ru',
@@ -4987,11 +5100,11 @@ let ConfigPrototype = {};
          * Delay before show tooltip
          */ this.showTooltipDelay = 200;
         /**
-         * Instead of create custop tooltip - use native title tooltips
+         * Instead of creating a custom tooltip, use the browser's native title tooltips
          */ this.useNativeTooltip = false;
         /**
-         * Default insert method
-         * @default insert_as_html
+         * How pasted content is inserted into the editor by default.
+         * Possible values: `insert_as_html`, `insert_as_text`, `insert_only_text`, `insert_clear_html`.
          */ this.defaultActionOnPaste = _core_constants_js__WEBPACK_IMPORTED_MODULE_0__.INSERT_AS_HTML;
         // TODO
         // autosave: false, // false or url
@@ -5004,7 +5117,6 @@ let ConfigPrototype = {};
         /**
          * When this option is enabled, the editor's content will be placed in an iframe and isolated from the rest of the page.
          *
-         * @example
          * ```javascript
          * Jodit.make('#editor', {
          *    iframe: true,
@@ -5016,7 +5128,7 @@ let ConfigPrototype = {};
         /**
          * Allow editing the entire HTML document(html, head)
          * \> Works together with the iframe option.
-         * @example
+         *
          * ```js
          * const editor = Jodit.make('#editor', {
          *   iframe: true,
@@ -5035,7 +5147,7 @@ let ConfigPrototype = {};
         /**
          * Jodit.MODE_WYSIWYG The HTML editor allows you to write like MSWord,
          * Jodit.MODE_SOURCE syntax highlighting source editor
-         * @example
+         *
          * ```javascript
          * var editor = Jodit.make('#editor', {
          *     defaultMode: Jodit.MODE_SPLIT
@@ -5044,11 +5156,11 @@ let ConfigPrototype = {};
          * ```
          */ this.defaultMode = _core_constants_js__WEBPACK_IMPORTED_MODULE_0__.MODE_WYSIWYG;
         /**
-         * Use split mode
+         * When enabled, the editor displays both the WYSIWYG view and the source-code view side by side.
          */ this.useSplitMode = false;
         /**
          * The colors in HEX representation to select a color for the background and for the text in colorpicker
-         * @example
+         *
          * ```javascript
          *  Jodit.make('#editor', {
          *     colors: ['#ff0000', '#00ff00', '#0000ff']
@@ -5144,7 +5256,7 @@ let ConfigPrototype = {};
         };
         /**
          * The default tab color picker
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor2', {
          *     colorPickerDefaultTab: 'color'
@@ -5152,11 +5264,11 @@ let ConfigPrototype = {};
          * ```
          */ this.colorPickerDefaultTab = 'background';
         /**
-         * Image size defaults to a larger image
+         * Default width (in pixels) applied to images inserted into the editor
          */ this.imageDefaultWidth = 300;
         /**
          * Do not display these buttons that are on the list
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor2', {
          *     removeButtons: ['hr', 'source']
@@ -5165,7 +5277,7 @@ let ConfigPrototype = {};
          */ this.removeButtons = [];
         /**
          * Do not init these plugins
-         * @example
+         *
          * ```typescript
          * var editor = Jodit.make('.editor', {
          *    disablePlugins: 'table,iframe'
@@ -5178,7 +5290,7 @@ let ConfigPrototype = {};
          */ this.disablePlugins = [];
         /**
          * Init and download extra plugins
-         * @example
+         *
          * ```typescript
          * var editor = Jodit.make('.editor', {
          *    extraPlugins: ['emoji']
@@ -5187,14 +5299,13 @@ let ConfigPrototype = {};
          * It will try load %SCRIPT_PATH%/plugins/emoji/emoji.js and after load will try init it
          */ this.extraPlugins = [];
         /**
-         * These buttons list will be added to the option. Buttons
+         * Additional buttons appended to the {@link Config.buttons} list
          */ this.extraButtons = [];
         /**
          * By default, you can only install an icon from the Jodit suite.
          * You can add your icon to the set using the `Jodit.modules.Icon.set (name, svg Code)` method.
          * But for a declarative declaration, you can use this option.
          *
-         * @example
          * ```js
          * Jodit.modules.Icon.set('someIcon', '<svg><path.../></svg>');
          * const editor = Jodit.make({
@@ -5203,8 +5314,9 @@ let ConfigPrototype = {};
          *     icon: 'someIcon'
          *   }]
          * });
+         * ```
          *
-         * @example
+         * ```js
          * const editor = Jodit.make({
          *   extraIcons: {
          *     someIcon: '<svg><path.../></svg>'
@@ -5215,7 +5327,7 @@ let ConfigPrototype = {};
          *   }]
          * });
          * ```
-         * @example
+         *
          * ```js
          * const editor = Jodit.make({
          *   extraButtons: [{
@@ -5227,7 +5339,7 @@ let ConfigPrototype = {};
          */ this.extraIcons = {};
         /**
          * Default attributes for created inside editor elements
-         * @example
+         *
          * ```js
          * const editor2 = Jodit.make('#editor', {
          * 	createAttributes: {
@@ -5247,7 +5359,7 @@ let ConfigPrototype = {};
          * expect(ul.className).equals('ui-test');
          * ```
          * Or JSX in React
-         * @example
+         *
          * ```jsx
          * import React, {useState, useRef} from 'react';
          * import JoditEditor from "jodit-react";
@@ -5279,7 +5391,7 @@ let ConfigPrototype = {};
         /**
          * The list of buttons that appear in the editor's toolbar on large places (≥ options.sizeLG).
          * Note - this is not the width of the device, the width of the editor
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor', {
          *     buttons: ['bold', 'italic', 'source'],
@@ -5287,7 +5399,7 @@ let ConfigPrototype = {};
          *     buttonsXS: ['bold', 'fullsize'],
          * });
          * ```
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor2', {
          *     buttons: [{
@@ -5311,7 +5423,7 @@ let ConfigPrototype = {};
          *     }]
          * });
          * ```
-         * @example
+         *
          * ```javascript
          * Jodit.make('#editor2', {
          *     buttons: Jodit.defaultOptions.buttons.concat([{
@@ -5432,7 +5544,7 @@ let ConfigPrototype = {};
          * ```
          */ this.events = {};
         /**
-         * Buttons in toolbat without SVG - only texts
+         * Buttons in toolbar without SVG - only texts
          */ this.textIcons = false;
         /**
          * Element for dialog container
@@ -24148,9 +24260,10 @@ _config_js__WEBPACK_IMPORTED_MODULE_0__.Config.prototype.toolbarStickyOffset = 0
 /* harmony import */ var _decorators_derive_derive_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(55153);
 /* harmony import */ var _dom_dom_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(2748);
 /* harmony import */ var _helpers_checker_is_string_js__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(70799);
-/* harmony import */ var _traits_elms_js__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(14316);
-/* harmony import */ var _traits_mods_js__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(34176);
-/* harmony import */ var _icon_js__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(12153);
+/* harmony import */ var _helpers_utils_attr_js__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(29960);
+/* harmony import */ var _traits_elms_js__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(14316);
+/* harmony import */ var _traits_mods_js__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(34176);
+/* harmony import */ var _icon_js__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(12153);
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
@@ -24169,7 +24282,11 @@ var UIElement_1;
 
 
 
+
 let UIElement = UIElement_1 = class UIElement extends _component_index_js__WEBPACK_IMPORTED_MODULE_0__.ViewComponent {
+    getRole() {
+        return '';
+    }
     get parentElement() {
         return this.__parentElement;
     }
@@ -24258,7 +24375,7 @@ let UIElement = UIElement_1 = class UIElement extends _component_index_js__WEBPA
         return result;
     }
     parseTemplate(result) {
-        return this.j.c.fromHTML(result.replace(/\*([^*]+?)\*/g, (_, name)=>_icon_js__WEBPACK_IMPORTED_MODULE_6__.Icon.get(name) || '').replace(/&_/g, this.componentName + '_').replace(/~([^~]+?)~/g, (_, s)=>this.i18n(s)));
+        return this.j.c.fromHTML(result.replace(/\*([^*]+?)\*/g, (_, name)=>_icon_js__WEBPACK_IMPORTED_MODULE_7__.Icon.get(name) || '').replace(/&_/g, this.componentName + '_').replace(/~([^~]+?)~/g, (_, s)=>this.i18n(s)));
     }
     /** @override */ destruct() {
         _dom_dom_js__WEBPACK_IMPORTED_MODULE_2__.Dom.safeRemove(this.container);
@@ -24271,6 +24388,8 @@ let UIElement = UIElement_1 = class UIElement extends _component_index_js__WEBPA
         this.__parentElement = null;
         this.mods = {};
         this.container = this.createContainer(options);
+        const role = this.getRole();
+        role && (0,_helpers_utils_attr_js__WEBPACK_IMPORTED_MODULE_4__.attr)(this.container, 'role', role);
         Object.defineProperty(this.container, 'component', {
             value: this,
             configurable: true
@@ -24278,7 +24397,7 @@ let UIElement = UIElement_1 = class UIElement extends _component_index_js__WEBPA
     }
 };
 UIElement = UIElement_1 = __decorate([
-    (0,_decorators_derive_derive_js__WEBPACK_IMPORTED_MODULE_1__.derive)(_traits_mods_js__WEBPACK_IMPORTED_MODULE_5__.Mods, _traits_elms_js__WEBPACK_IMPORTED_MODULE_4__.Elms)
+    (0,_decorators_derive_derive_js__WEBPACK_IMPORTED_MODULE_1__.derive)(_traits_mods_js__WEBPACK_IMPORTED_MODULE_6__.Mods, _traits_elms_js__WEBPACK_IMPORTED_MODULE_5__.Elms)
 ], UIElement);
 
 
@@ -31258,6 +31377,9 @@ let UIGroup = UIGroup_1 = class UIGroup extends _element_js__WEBPACK_IMPORTED_MO
     className() {
         return 'UIGroup';
     }
+    getRole() {
+        return 'list';
+    }
     /**
      * All group children
      */ get allChildren() {
@@ -38609,6 +38731,9 @@ let ToolbarButton = class ToolbarButton extends _core_ui_button_index_js__WEBPAC
     className() {
         return 'ToolbarButton';
     }
+    getRole() {
+        return 'listitem';
+    }
     /**
      * Get parent toolbar
      */ get toolbar() {
@@ -38676,7 +38801,6 @@ let ToolbarButton = class ToolbarButton extends _core_ui_button_index_js__WEBPAC
         const cn = this.componentName;
         const container = this.j.c.span(cn);
         const button = super.createContainer();
-        (0,_core_helpers_utils_attr_js__WEBPACK_IMPORTED_MODULE_14__.attr)(container, 'role', 'listitem');
         button.classList.remove(cn);
         button.classList.add(cn + '__button');
         Object.defineProperty(button, 'component', {
@@ -41556,13 +41680,12 @@ _config_js__WEBPACK_IMPORTED_MODULE_0__.Config.prototype.maxWidth = '100%';
 /**
  * Editor's min-height
  *
- * @example
  * ```javascript
  * Jodit.make('.editor', {
  *    minHeight: '30%' //min-height: 30%
  * })
  * ```
- * @example
+ *
  * ```javascript
  * Jodit.make('.editor', {
  *    minHeight: 200 //min-height: 200px
@@ -42620,7 +42743,7 @@ __webpack_require__.r(__webpack_exports__);
  * ```
  * @packageDocumentation
  * @module constants
- */ const APP_VERSION = "4.9.21";
+ */ const APP_VERSION = "4.9.22";
 // prettier-ignore
 const ES = "es2021";
 const IS_ES_MODERN = true;