jodit 3.10.2 → 3.12.2

package/src/core/ui/README.md

@@ -0,0 +1,51 @@
+# Jodit UI System
+
+For interface design, Jodit provides a set of components that allow you to build complex interfaces.
+Their advantage is the uniformity of the insert/drop interfaces. Reactivity created by observing the fields of the component.
+
+Each UI element must implement the interface [[IIUElement]], and should extend [[UIElement]].
+
+> For each element to work, an instance is required when creating it [[IView]]
+
+```ts
+import './style.less'
+
+import { UIElement } from 'jodit/src/core/ui';
+import { component } from 'jodit/src/core/decorators';
+
+@component()
+export class UISlider extends UIElement {
+	className() {
+		return 'UISlider';
+	}
+
+	render(): string {
+		return `<div>
+			<div class="&__wrapper">
+			  <div class="&__item">1</div>
+			  <div class="&__item">2</div>
+			  <div class="&__item">3</div>
+			</div>
+		</div>`;
+	}
+}
+```
+
+Pay attention to the styles. They connect explicitly.
+
+File `style.less`
+```less
+.jodit-ui-slider {
+  &__wrapper {
+    display: flex;
+    overflow: scroll;
+  }
+
+  &__slider-item {
+    display: flex;
+    width: 200px;
+    height: 100px;
+    background-color: red;
+  }
+}
+```

package/src/core/ui/button/README.md

@@ -0,0 +1,3 @@
+# Jodit Button UI Element
+
+Component for creating buttons.

package/src/core/ui/button/button/button.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../../styles/variables';

package/src/core/ui/button/button/button.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/button
  */
 
 import './button.less';
@@ -17,7 +21,7 @@ import { UIElement } from '../../element';
 import { Dom } from '../../../dom';
 import { attr, isString, isFunction } from '../../../helpers';
 import { Icon } from '../../icon';
-import { UIList } from '../../list/list';
+import { UIList } from '../../group';
 import { autobind, component, watch } from '../../../decorators';
 import { STATUSES } from '../../../component';
 

package/src/core/ui/button/group/group.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/button
  */
 
 import './group.less';
@@ -12,7 +16,7 @@ import type {
 	IUIOption,
 	IViewBased
 } from '../../../../types';
-import { UIGroup } from '../../list/group';
+import { UIGroup } from '../../group';
 import { component } from '../../../decorators';
 import { UIButton } from '../button/button';
 

package/src/core/ui/button/index.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/button/README.md]]
+ * @packageDocumentation
+ * @module ui/button
  */
 
 export * from './button/button';

package/src/core/ui/element.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui
  */
 
 import type {

package/src/core/ui/form/README.md

@@ -0,0 +1,22 @@
+# Jodit Form UI Element
+
+Component for creating form interfaces.
+
+```ts
+import { UIForm, UIInput, UIBlock } from 'jodit/src/core/ui';
+
+const form = new UIForm(jodit, [
+	new UIInput(editor, {
+		required: true,
+		label: 'URL',
+		name: 'url',
+		type: 'text',
+		placeholder: 'https://'
+	}),
+	new UIInput(editor, {
+		name: 'text',
+		label: 'Alternative text'
+	}),
+	new UIBlock(editor, [button])
+]);
+```

package/src/core/ui/form/block/block.ts

@@ -1,13 +1,17 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/block
  */
 
 import './block.less';
 
 import type { IUIElement, IViewBased } from '../../../../types';
-import { UIGroup } from '../../list/group';
+import { UIGroup } from '../../group';
 import { attr } from '../../../helpers/utils';
 import { component } from '../../../decorators';
 

package/src/core/ui/form/form.ts

@@ -1,11 +1,17 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/form/README.md]]
+ * @packageDocumentation
+ * @module ui/form
  */
 
 import type { IDictionary, IUIForm, IUIInput, IUISelect } from '../../../types';
-import { UIGroup } from '../list/group';
+import { UIGroup } from '../group';
 import { UIInput, UISelect } from './inputs';
 import { attr } from '../../helpers/utils';
 import { component } from '../../decorators';

package/src/core/ui/form/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form
  */
 
 export * from './form';

package/src/core/ui/form/inputs/area/area.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 import './area.less';

package/src/core/ui/form/inputs/checkbox/checkbox.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 import './checkbox.less';

package/src/core/ui/form/inputs/file/file.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 import './file.less';

package/src/core/ui/form/inputs/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 export * from './input/input';

package/src/core/ui/form/inputs/input/input.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 import './input.less';

package/src/core/ui/form/inputs/select/select.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form/inputs
  */
 
 import './select.less';

package/src/core/ui/form/validators/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form
  */
 
 export * as inputValidators from './input';

package/src/core/ui/form/validators/input.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form
  */
 
 import type { IUIInput, IUIInputValidator } from '../../../../types';

package/src/core/ui/form/validators/select.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/form
  */
 
 import type { IUIInputValidator } from '../../../../types';

package/src/core/ui/group/README.md

@@ -0,0 +1 @@
+Group component

package/src/core/ui/{list → group}/group.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../styles/variables';

package/src/core/ui/{list → group}/group.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/group/README.md]]
+ * @packageDocumentation
+ * @module ui/group
  */
 
 import './group.less';

package/src/core/ui/{list → group}/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/group
  */
 
 export * from './group';

package/src/core/ui/{list → group}/list.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../styles/variables';

package/src/core/ui/{list → group}/list.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/group
  */
 
 import './list.less';

package/src/core/ui/{list → group}/separator.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/group
  */
 
 import { UIElement } from '../element';

package/src/core/ui/{list → group}/spacer.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/group
  */
 
 import { UIElement } from '../element';

package/src/core/ui/helpers/buttons.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui
  */
 
 import type {

package/src/core/ui/helpers/get-control-type.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui
  */
 
 import type {

package/src/core/ui/helpers/get-strong-control-types.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui
  */
 
 import type {

package/src/core/ui/icon.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui
  */
 
 import type {
@@ -10,7 +14,7 @@ import type {
 	IUIIconState,
 	IViewBased
 } from '../../types';
-import { css } from '../helpers/css';
+import { css } from '../helpers';
 
 export class Icon {
 	private static icons: IDictionary<string> = {};

package/src/core/ui/index.ts

@@ -1,13 +1,19 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/README.md]]
+ * @packageDocumentation
+ * @module ui
  */
 
 export * from './element';
 export * from './button';
 export * from './popup';
-export * from './list';
+export * from './group';
 export * from './form';
 export * from './icon';
 export * from './progress-bar/progress-bar';

package/src/core/ui/popup/README.md

@@ -0,0 +1,15 @@
+# Jodit UI Popup
+
+The module is used to create pop-up windows next to interface elements.
+
+```js
+import { Popup } from 'jodit/src/core/ui';
+
+const popup = new Popup(jodit);
+popup.setContent('Hello world').open(() => ({
+	left: 100,
+	top: 200
+}));
+
+popup.close();
+```

package/src/core/ui/popup/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module ui/popup
  */
 
 export * from './popup';

package/src/core/ui/popup/popup.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../styles/variables';

package/src/core/ui/popup/popup.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/popup/README.md]]
+ * @packageDocumentation
+ * @module ui/popup
  */
 
 import './popup.less';
@@ -21,6 +27,7 @@ import { Dom } from '../../dom';
 import {
 	attr,
 	css,
+	isFunction,
 	isString,
 	kebabCase,
 	markOwner,
@@ -362,12 +369,15 @@ export class Popup extends UIElement implements IPopup {
 			return;
 		}
 
-		if (!e.target) {
+		const target =
+			(isFunction(e.composedPath) && e.composedPath()[0]) ?? e.target;
+
+		if (!target) {
 			this.close();
 			return;
 		}
 
-		const box = UIElement.closestElement(e.target as Node, Popup);
+		const box = UIElement.closestElement(target as Node, Popup);
 
 		if (box && (this === box || box.closest(this))) {
 			return;

package/src/core/ui/progress-bar/README.md

@@ -0,0 +1 @@
+# Jodit Progress Bar UI element

package/src/core/ui/progress-bar/progress-bar.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../styles/variables';

package/src/core/ui/progress-bar/progress-bar.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:core/ui/progress-bar/README.md]]
+ * @packageDocumentation
+ * @module ui/progress-bar
  */
 
 import './progress-bar.less';