@ckeditor/ckeditor5-comments 38.0.1 → 38.1.1

package/src/annotations/annotationcollection.d.ts

@@ -1,94 +1,94 @@
-/**
- * @module comments/annotations/annotationcollection
- * @publicApi
- */
-import { Collection } from 'ckeditor5/src/utils';
-import type { View } from 'ckeditor5/src/ui';
-import type Annotation from './annotation';
-/**
- * A collection of {@link module:comments/annotations/annotation~Annotation annotations}.
- *
- * It implements methods for managing annotations and creates a focus tracker for them to make it easier to manage
- * the focus for all annotations.
- *
- * `AnnotationCollection` fires {@link module:comments/annotations/annotationcollection~AnnotationCollection#event:focus} when an annotation
- * becomes focused and {@link module:comments/annotations/annotationcollection~AnnotationCollection#event:blur} when all annotations
- * lose focus.
- */
-export default class AnnotationCollection extends Collection<Annotation> {
-    /**
-     * @param annotations Initial annotations.
-     */
-    constructor(annotations?: Iterable<Annotation>);
-    /**
-    * Equals to `true` when one of the annotation in the collection is focused.
-    */
-    get isFocused(): boolean;
-    /**
-     * Adds an annotation to the collection.
-     */
-    add(annotation: Annotation): this;
-    /**
-     * Removes the annotation from the collection.
-     */
-    remove(annotation: Annotation): Annotation;
-    /**
-     * Gets the annotation for a given annotation view's inner view.
-     */
-    getByInnerView(innerView: View): Annotation | undefined;
-    /**
-     * Gets the annotation for a given annotation view.
-     */
-    getByView(view: View): Annotation | undefined;
-    /**
-     * Destroys all bindings and clears the collection.
-     */
-    destroy(): void;
-    /**
-     * Refreshes the positioning of all annotations and sorts them topmost and leftmost.
-     */
-    refreshPositioning(): void;
-}
-/**
- * Fired when an annotation becomes active.
- *
- * @eventName ~AnnotationCollection#focus
- * @param annotation An annotation that was focused.
- */
-export type AnnotationFocusEvent = {
-    name: 'focus';
-    args: [annotation: Annotation];
-};
-/**
- * Fired when all annotations become blurred.
- *
- * @eventName ~AnnotationCollection#blur
- */
-export type AnnotationBlurEvent = {
-    name: 'blur';
-    args: [];
-};
-/**
- * A helper function that binds two {@link module:comments/annotations/annotationcollection~AnnotationCollection AnnotationCollection}s
- * and allows filtering items based on the passed callback.
- *
- * Since {@link module:comments/annotations/annotationcollection~AnnotationCollection#refreshPositioning}
- * sorts the annotations by removing and inserting items, the binding implemented by the `bindTo()` method is lost. This is why
- * this helper needs to be used.
- *
- * This helper is used by the annotations UIs to filter which annotations from the
- * {@link module:comments/annotations/annotations~Annotations#collection main annotation collection} should be handled by
- * a given annotations UI.
- *
- * @param `options.source` The source collection
- * from which the annotations will be taken.
- * @param `options.target` The target collection
- * that will be synced to the source collection.
- * @param options.filter Filtering function that gets an annotation and should return `true` if the annotation should be
- * copied to the `target` collection.
- */
-export declare function bindAnnotationCollections({ source, target, filter }: {
-    source: AnnotationCollection;
-    target: AnnotationCollection;
-    filter: (annotation: Annotation) => boolean;
-}): void;
+/**
+ * @module comments/annotations/annotationcollection
+ * @publicApi
+ */
+import { Collection } from 'ckeditor5/src/utils';
+import type { View } from 'ckeditor5/src/ui';
+import type Annotation from './annotation';
+/**
+ * A collection of {@link module:comments/annotations/annotation~Annotation annotations}.
+ *
+ * It implements methods for managing annotations and creates a focus tracker for them to make it easier to manage
+ * the focus for all annotations.
+ *
+ * `AnnotationCollection` fires {@link module:comments/annotations/annotationcollection~AnnotationCollection#event:focus} when an annotation
+ * becomes focused and {@link module:comments/annotations/annotationcollection~AnnotationCollection#event:blur} when all annotations
+ * lose focus.
+ */
+export default class AnnotationCollection extends Collection<Annotation> {
+    /**
+     * @param annotations Initial annotations.
+     */
+    constructor(annotations?: Iterable<Annotation>);
+    /**
+    * Equals to `true` when one of the annotation in the collection is focused.
+    */
+    get isFocused(): boolean;
+    /**
+     * Adds an annotation to the collection.
+     */
+    add(annotation: Annotation): this;
+    /**
+     * Removes the annotation from the collection.
+     */
+    remove(annotation: Annotation): Annotation;
+    /**
+     * Gets the annotation for a given annotation view's inner view.
+     */
+    getByInnerView(innerView: View): Annotation | undefined;
+    /**
+     * Gets the annotation for a given annotation view.
+     */
+    getByView(view: View): Annotation | undefined;
+    /**
+     * Destroys all bindings and clears the collection.
+     */
+    destroy(): void;
+    /**
+     * Refreshes the positioning of all annotations and sorts them topmost and leftmost.
+     */
+    refreshPositioning(): void;
+}
+/**
+ * Fired when an annotation becomes active.
+ *
+ * @eventName ~AnnotationCollection#focus
+ * @param annotation An annotation that was focused.
+ */
+export type AnnotationFocusEvent = {
+    name: 'focus';
+    args: [annotation: Annotation];
+};
+/**
+ * Fired when all annotations become blurred.
+ *
+ * @eventName ~AnnotationCollection#blur
+ */
+export type AnnotationBlurEvent = {
+    name: 'blur';
+    args: [];
+};
+/**
+ * A helper function that binds two {@link module:comments/annotations/annotationcollection~AnnotationCollection AnnotationCollection}s
+ * and allows filtering items based on the passed callback.
+ *
+ * Since {@link module:comments/annotations/annotationcollection~AnnotationCollection#refreshPositioning}
+ * sorts the annotations by removing and inserting items, the binding implemented by the `bindTo()` method is lost. This is why
+ * this helper needs to be used.
+ *
+ * This helper is used by the annotations UIs to filter which annotations from the
+ * {@link module:comments/annotations/annotations~Annotations#collection main annotation collection} should be handled by
+ * a given annotations UI.
+ *
+ * @param `options.source` The source collection
+ * from which the annotations will be taken.
+ * @param `options.target` The target collection
+ * that will be synced to the source collection.
+ * @param options.filter Filtering function that gets an annotation and should return `true` if the annotation should be
+ * copied to the `target` collection.
+ */
+export declare function bindAnnotationCollections({ source, target, filter }: {
+    source: AnnotationCollection;
+    target: AnnotationCollection;
+    filter: (annotation: Annotation) => boolean;
+}): void;

package/src/annotations/annotationcollection.js

@@ -20,4 +20,4 @@
  *
  *
  */
-const _0x1708=['has','top','getByView','updateTargetRect','delete','_focusTracker','change:isFocused','focusTracker','from','isFocused','add','listenTo','fire','stopListening','left','length','view','_viewToAnnotation','clear','destroy','_sort','blur','annotationcollection-not-existing-item','get','annotationcollection-duplicated-item','_innerViewToAnnotation','remove','innerView','set','targetRect','focusableElements','_getOrderInContent','getByInnerView'];(function(_0x314aaa,_0x170822){const _0x1eccc0=function(_0x5ab52d){while(--_0x5ab52d){_0x314aaa['push'](_0x314aaa['shift']());}};_0x1eccc0(++_0x170822);}(_0x1708,0x133));const _0x1ecc=function(_0x314aaa,_0x170822){_0x314aaa=_0x314aaa-0x0;let _0x1eccc0=_0x1708[_0x314aaa];return _0x1eccc0;};import{CKEditorError as _0x312820,Collection as _0x38037a,FocusTracker as _0x2b8a64}from'ckeditor5/src/utils';export default class x extends _0x38037a{constructor(_0xd3e954=[]){super(),this[_0x1ecc('0xf')]=new Map(),this['_viewToAnnotation']=new Map(),this['_focusTracker']=new _0x2b8a64(),this[_0x1ecc('0x1c')]['on'](_0x1ecc('0x1d'),(_0x55c6ea,_0x588ee6,_0xc72de5)=>{_0xc72de5||this[_0x1ecc('0x2')](_0x1ecc('0xb'));});for(const _0x266f9b of _0xd3e954)this[_0x1ecc('0x0')](_0x266f9b);}get[_0x1ecc('0x20')](){return this['_focusTracker']['isFocused'];}[_0x1ecc('0x0')](_0x1ab854){if(this[_0x1ecc('0x17')](_0x1ab854))throw new _0x312820(_0x1ecc('0xe'),null);this[_0x1ecc('0xf')][_0x1ecc('0x12')](_0x1ab854[_0x1ecc('0x11')],_0x1ab854),this[_0x1ecc('0x7')][_0x1ecc('0x12')](_0x1ab854[_0x1ecc('0x6')],_0x1ab854);for(const _0x2764e3 of _0x1ab854[_0x1ecc('0x14')])this[_0x1ecc('0x1c')][_0x1ecc('0x0')](_0x2764e3);this[_0x1ecc('0x1')](_0x1ab854[_0x1ecc('0x14')],'add',(_0x34d1ac,_0x220273)=>{this[_0x1ecc('0x1c')][_0x1ecc('0x0')](_0x220273);}),this[_0x1ecc('0x1')](_0x1ab854['focusableElements'],_0x1ecc('0x10'),(_0xd4f16b,_0x4e99e8)=>{this['_focusTracker']['remove'](_0x4e99e8);}),this[_0x1ecc('0x1')](_0x1ab854['view'][_0x1ecc('0x1e')],_0x1ecc('0x1d'),(_0x47e616,_0x397b91,_0x3b4fc8)=>{_0x3b4fc8&&this[_0x1ecc('0x2')]('focus',_0x1ab854);}),_0x1ab854[_0x1ecc('0x1a')]();const _0x4f59c5=this[_0x1ecc('0x15')](_0x1ab854[_0x1ecc('0x6')][_0x1ecc('0x13')]);return super[_0x1ecc('0x0')](_0x1ab854,_0x4f59c5);}[_0x1ecc('0x10')](_0x188a85){if(!this[_0x1ecc('0x17')](_0x188a85))throw new _0x312820(_0x1ecc('0xc'),null);this[_0x1ecc('0x3')](_0x188a85[_0x1ecc('0x6')][_0x1ecc('0x1e')]),this['stopListening'](_0x188a85[_0x1ecc('0x14')]);for(const _0x5deb53 of _0x188a85[_0x1ecc('0x14')])this[_0x1ecc('0x1c')][_0x1ecc('0x10')](_0x5deb53);return this[_0x1ecc('0x7')][_0x1ecc('0x1b')](_0x188a85[_0x1ecc('0x6')]),this[_0x1ecc('0xf')][_0x1ecc('0x1b')](_0x188a85[_0x1ecc('0x11')]),super[_0x1ecc('0x10')](_0x188a85);}[_0x1ecc('0x16')](_0x5e58c5){return this[_0x1ecc('0xf')][_0x1ecc('0xd')](_0x5e58c5);}[_0x1ecc('0x19')](_0x27d52c){return this[_0x1ecc('0x7')][_0x1ecc('0xd')](_0x27d52c);}[_0x1ecc('0x9')](){super[_0x1ecc('0x8')](),this[_0x1ecc('0x3')](),this['_innerViewToAnnotation']['clear'](),this[_0x1ecc('0x7')][_0x1ecc('0x8')](),this['_focusTracker'][_0x1ecc('0x9')]();}['refreshPositioning'](){for(const _0x1ff83a of this)_0x1ff83a[_0x1ecc('0x1a')]();this[_0x1ecc('0xa')]();}['_sort'](){const _0x50d2f9=Array[_0x1ecc('0x1f')](this)['sort']((_0x531c44,_0x5caa93)=>v(_0x531c44[_0x1ecc('0x6')][_0x1ecc('0x13')],_0x5caa93[_0x1ecc('0x6')][_0x1ecc('0x13')]));for(let _0x232c86=_0x50d2f9[_0x1ecc('0x5')]-0x1;_0x232c86>0x0;_0x232c86--){const _0x341244=_0x50d2f9[_0x232c86];_0x232c86!==this['getIndex'](_0x341244)&&(this[_0x1ecc('0x10')](_0x341244),this['add'](_0x341244));}}[_0x1ecc('0x15')](_0x46a904){let _0x159192=0x0;if(!_0x46a904)return this[_0x1ecc('0x5')];for(const _0x1e9b65 of this){const _0x3b1ebb=_0x1e9b65['view']['targetRect'];if(_0x3b1ebb){if(v(_0x46a904,_0x3b1ebb)<0x0)return _0x159192;_0x159192++;}}return _0x159192;}}export function bindAnnotationCollections({source:_0x3c88d5,target:_0x1d83a4,filter:_0x197684}){for(const _0x150e8f of _0x3c88d5)_0x197684(_0x150e8f)&&_0x1d83a4['add'](_0x150e8f);_0x1d83a4[_0x1ecc('0x1')](_0x3c88d5,_0x1ecc('0x0'),(_0x291dda,_0x57dad6)=>{_0x197684(_0x57dad6)&&_0x1d83a4[_0x1ecc('0x0')](_0x57dad6);}),_0x1d83a4[_0x1ecc('0x1')](_0x3c88d5,_0x1ecc('0x10'),(_0x49cb9d,_0x52f842)=>{_0x1d83a4[_0x1ecc('0x17')](_0x52f842)&&_0x1d83a4[_0x1ecc('0x10')](_0x52f842);});}function v(_0x339779,_0x3f9b48){if(null===_0x339779&&null===_0x3f9b48)return 0x0;if(null===_0x339779)return-0x1;if(null===_0x3f9b48)return 0x1;const _0x2610ac=_0x339779[_0x1ecc('0x18')]-_0x3f9b48[_0x1ecc('0x18')];return 0x0==_0x2610ac?_0x339779[_0x1ecc('0x4')]-_0x3f9b48[_0x1ecc('0x4')]:_0x2610ac;}
+const _0x32ea=['_getOrderInContent','_innerViewToAnnotation','remove','top','isFocused','fire','annotationcollection-not-existing-item','targetRect','destroy','blur','has','updateTargetRect','length','clear','getIndex','delete','getByInnerView','_sort','focusableElements','refreshPositioning','annotationcollection-duplicated-item','left','focusTracker','set','get','sort','view','from','innerView','listenTo','add','change:isFocused','_viewToAnnotation','stopListening','focus','_focusTracker','getByView'];(function(_0x124e3b,_0x32ea64){const _0x310ff0=function(_0x37bc59){while(--_0x37bc59){_0x124e3b['push'](_0x124e3b['shift']());}};_0x310ff0(++_0x32ea64);}(_0x32ea,0xb0));const _0x310f=function(_0x124e3b,_0x32ea64){_0x124e3b=_0x124e3b-0x0;let _0x310ff0=_0x32ea[_0x124e3b];return _0x310ff0;};import{CKEditorError as _0x5a6e77,Collection as _0x22193f,FocusTracker as _0x43fefe}from'ckeditor5/src/utils';export default class x extends _0x22193f{constructor(_0x3e3c73=[]){super(),this[_0x310f('0xa')]=new Map(),this[_0x310f('0x4')]=new Map(),this[_0x310f('0x7')]=new _0x43fefe(),this[_0x310f('0x7')]['on'](_0x310f('0x3'),(_0x388767,_0x57319f,_0x4b0f0f)=>{_0x4b0f0f||this[_0x310f('0xe')](_0x310f('0x12'));});for(const _0x3dfe11 of _0x3e3c73)this[_0x310f('0x2')](_0x3dfe11);}get[_0x310f('0xd')](){return this[_0x310f('0x7')][_0x310f('0xd')];}[_0x310f('0x2')](_0x40c375){if(this[_0x310f('0x13')](_0x40c375))throw new _0x5a6e77(_0x310f('0x1d'),null);this[_0x310f('0xa')][_0x310f('0x20')](_0x40c375[_0x310f('0x0')],_0x40c375),this[_0x310f('0x4')][_0x310f('0x20')](_0x40c375[_0x310f('0x23')],_0x40c375);for(const _0x2b4983 of _0x40c375[_0x310f('0x1b')])this[_0x310f('0x7')]['add'](_0x2b4983);this[_0x310f('0x1')](_0x40c375[_0x310f('0x1b')],'add',(_0x43995c,_0x3976d5)=>{this['_focusTracker'][_0x310f('0x2')](_0x3976d5);}),this[_0x310f('0x1')](_0x40c375[_0x310f('0x1b')],_0x310f('0xb'),(_0x1489d8,_0x494b9c)=>{this['_focusTracker'][_0x310f('0xb')](_0x494b9c);}),this[_0x310f('0x1')](_0x40c375[_0x310f('0x23')][_0x310f('0x1f')],_0x310f('0x3'),(_0x9fe4bf,_0x2aeedc,_0x21510c)=>{_0x21510c&&this[_0x310f('0xe')](_0x310f('0x6'),_0x40c375);}),_0x40c375[_0x310f('0x14')]();const _0x575fb6=this[_0x310f('0x9')](_0x40c375[_0x310f('0x23')][_0x310f('0x10')]);return super[_0x310f('0x2')](_0x40c375,_0x575fb6);}[_0x310f('0xb')](_0x8ebe37){if(!this[_0x310f('0x13')](_0x8ebe37))throw new _0x5a6e77(_0x310f('0xf'),null);this[_0x310f('0x5')](_0x8ebe37['view'][_0x310f('0x1f')]),this[_0x310f('0x5')](_0x8ebe37[_0x310f('0x1b')]);for(const _0x412990 of _0x8ebe37['focusableElements'])this[_0x310f('0x7')][_0x310f('0xb')](_0x412990);return this[_0x310f('0x4')][_0x310f('0x18')](_0x8ebe37[_0x310f('0x23')]),this[_0x310f('0xa')][_0x310f('0x18')](_0x8ebe37[_0x310f('0x0')]),super[_0x310f('0xb')](_0x8ebe37);}[_0x310f('0x19')](_0x223d1a){return this[_0x310f('0xa')][_0x310f('0x21')](_0x223d1a);}[_0x310f('0x8')](_0x2bd6a){return this[_0x310f('0x4')]['get'](_0x2bd6a);}[_0x310f('0x11')](){super[_0x310f('0x16')](),this[_0x310f('0x5')](),this[_0x310f('0xa')][_0x310f('0x16')](),this['_viewToAnnotation'][_0x310f('0x16')](),this[_0x310f('0x7')]['destroy']();}[_0x310f('0x1c')](){for(const _0x3de194 of this)_0x3de194[_0x310f('0x14')]();this[_0x310f('0x1a')]();}[_0x310f('0x1a')](){const _0x4a79b3=Array[_0x310f('0x24')](this)[_0x310f('0x22')]((_0x356082,_0x1e6338)=>v(_0x356082[_0x310f('0x23')][_0x310f('0x10')],_0x1e6338[_0x310f('0x23')]['targetRect']));for(let _0x19d0e8=_0x4a79b3[_0x310f('0x15')]-0x1;_0x19d0e8>0x0;_0x19d0e8--){const _0x433bbc=_0x4a79b3[_0x19d0e8];_0x19d0e8!==this[_0x310f('0x17')](_0x433bbc)&&(this['remove'](_0x433bbc),this['add'](_0x433bbc));}}['_getOrderInContent'](_0x3d8f63){let _0x34a625=0x0;if(!_0x3d8f63)return this[_0x310f('0x15')];for(const _0x4452a8 of this){const _0x47b833=_0x4452a8[_0x310f('0x23')]['targetRect'];if(_0x47b833){if(v(_0x3d8f63,_0x47b833)<0x0)return _0x34a625;_0x34a625++;}}return _0x34a625;}}export function bindAnnotationCollections({source:_0x7ed3f,target:_0x2b705a,filter:_0x53b583}){for(const _0x2a7988 of _0x7ed3f)_0x53b583(_0x2a7988)&&_0x2b705a['add'](_0x2a7988);_0x2b705a[_0x310f('0x1')](_0x7ed3f,_0x310f('0x2'),(_0x1276c4,_0x4c1cef)=>{_0x53b583(_0x4c1cef)&&_0x2b705a[_0x310f('0x2')](_0x4c1cef);}),_0x2b705a['listenTo'](_0x7ed3f,_0x310f('0xb'),(_0x11cff3,_0x59e1f3)=>{_0x2b705a['has'](_0x59e1f3)&&_0x2b705a[_0x310f('0xb')](_0x59e1f3);});}function v(_0x1aae34,_0x144936){if(null===_0x1aae34&&null===_0x144936)return 0x0;if(null===_0x1aae34)return-0x1;if(null===_0x144936)return 0x1;const _0x12c845=_0x1aae34[_0x310f('0xc')]-_0x144936[_0x310f('0xc')];return 0x0==_0x12c845?_0x1aae34[_0x310f('0x1e')]-_0x144936['left']:_0x12c845;}

package/src/annotations/annotations.d.ts

@@ -1,150 +1,150 @@
-/**
- * @module comments/annotations/annotations
- * @publicApi
- */
-import { ContextPlugin, type Context, type Editor } from 'ckeditor5/src/core';
-import type { View } from 'ckeditor5/src/ui';
-import { type Locale } from 'ckeditor5/src/utils';
-import Annotation, { type AnnotationTarget } from './annotation';
-import AnnotationCollection from './annotationcollection';
-import AnnotationView, { type AnnotationMainView } from './view/annotationview';
-/**
- * Stores and manages all {@link module:comments/annotations/annotation~Annotation annotations} created
- * for the entire {@link module:core/context~Context} or {@link module:core/editor/editor~Editor}.
- *
- * It allows for {@link module:comments/annotations/annotations~Annotations#add adding} and
- * {@link module:comments/annotations/annotations~Annotations#remove removing} annotations.
- *
- * It manages {@link module:comments/annotations/annotations~Annotations#activate activating} and
- * {@link module:comments/annotations/annotations~Annotations#deactivateAll deactivating} annotations. Using those methods will
- * result in setting {@link module:comments/annotations/annotationsuis~AnnotationUI#activeAnnotation} in the appropriate
- * {@link module:comments/annotations/annotationsuis~AnnotationsUI annotations UI} plugins.
- *
- * All active annotations are stored in {@link module:comments/annotations/annotations~Annotations#activeAnnotations}.
- *
- * `Annotations` is linked with {@link module:comments/annotations/annotationsuis~AnnotationsUIs}, which listens to events fired by
- * `Annotations` and propagates information to and from annotations UI plugins.
- */
-export default class Annotations extends ContextPlugin {
-    /**
-     * A set of currently active annotations.
-     *
-     * @observable
-     */
-    activeAnnotations: Set<Annotation>;
-    /**
-     * A collection of all annotations. It should not be operated on directly.
-     */
-    readonly collection: AnnotationCollection;
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): 'Annotations';
-    /**
-     * @inheritDoc
-     */
-    constructor(context: Context | Editor);
-    /**
-     * Adds an annotation to the collection.
-     */
-    add(annotation: Annotation): void;
-    /**
-     * Removes the given annotation from the collection.
-     */
-    remove(annotation: Annotation): void;
-    /**
-     * Refreshes the visibility of annotations based on the visibility of their annotation targets.
-     *
-     * This method should be called when one or more annotations' targets changed their visibility,
-     * for example when one of the editors was shown or hidden.
-     *
-     * This method recalculates all annotations' {@link module:comments/annotations/annotation~Annotation#isVisible `isVisible`} property.
-     */
-    refreshVisibility(): void;
-    /**
-     * Refreshes the positioning of all visible annotations and sorts them topmost and leftmost.
-     */
-    refreshPositioning(): void;
-    /**
-     * Returns the annotation that "contains" the given annotation view's inner view.
-     */
-    getByInnerView(innerView: View): Annotation | undefined;
-    /**
-     * Deactivates all active annotations.
-     *
-     * @fires _deactivateAllAnnotations
-     */
-    deactivateAll(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Activates the given annotation.
-     *
-     * If annotations UI that handles the given annotation already has an active annotation,
-     * then it deactivates it and activates the provided one.
-     *
-     * @fires _activateAnnotation
-     */
-    activate(annotation: Annotation): void;
-    /**
-     * Creates an annotation.
-     *
-     * ```ts
-     * const annotationView = annotations.createAnnotationView( editor.locale, innerView );
-     *
-     * const annotation = annotations.createAnnotation( {
-     * 	view: annotationView,
-     * 	target: document.getElementById( 'target' ),
-     * 	type: 'comment'
-     * } );
-     * ```
-     *
-     * @returns An annotation.
-     */
-    createAnnotation(options: AnnotationOptions): Annotation;
-    /**
-     * Creates an annotation view wrapper for the annotation content.
-     *
-     * ```ts
-     * const innerView = createCustomView();
-     * const annotationView = annotations.createAnnotationView( editor.locale, innerView );
-     * ```
-     *
-     * @returns An annotation view.
-     */
-    createAnnotationView(locale: Locale, view: AnnotationMainView): AnnotationView;
-}
-/**
- * The configuration options which are used to create new {@link module:comments/annotations/annotation~Annotation annotations}.
- *
- * @param view The annotation view.
- * @param target The annotation target.
- * @param type The annotation type.
- * @param isVisible The initial visibility of the annotation.
- */
-export interface AnnotationOptions {
-    view: AnnotationView;
-    target: AnnotationTarget;
-    type: string | (() => string);
-    isVisible?: boolean;
-}
-/**
- * An internal event that fires when the annotation should be activated.
- *
- * @eventName ~Annotations#_activateAnnotation
- */
-export type ActivateAnnotationEvent = {
-    name: '_activateAnnotation';
-    args: [annotation: Annotation];
-};
-/**
- * An internal event that fires when all annotations should be deactivated.
- *
- * @eventName ~Annotations#_deactivateAllAnnotations
- */
-export type DeactivateAllAnnotationsEvent = {
-    name: '_deactivateAllAnnotations';
-    args: [];
-};
+/**
+ * @module comments/annotations/annotations
+ * @publicApi
+ */
+import { ContextPlugin, type Context, type Editor } from 'ckeditor5/src/core';
+import type { View } from 'ckeditor5/src/ui';
+import { type Locale } from 'ckeditor5/src/utils';
+import Annotation, { type AnnotationTarget } from './annotation';
+import AnnotationCollection from './annotationcollection';
+import AnnotationView, { type AnnotationMainView } from './view/annotationview';
+/**
+ * Stores and manages all {@link module:comments/annotations/annotation~Annotation annotations} created
+ * for the entire {@link module:core/context~Context} or {@link module:core/editor/editor~Editor}.
+ *
+ * It allows for {@link module:comments/annotations/annotations~Annotations#add adding} and
+ * {@link module:comments/annotations/annotations~Annotations#remove removing} annotations.
+ *
+ * It manages {@link module:comments/annotations/annotations~Annotations#activate activating} and
+ * {@link module:comments/annotations/annotations~Annotations#deactivateAll deactivating} annotations. Using those methods will
+ * result in setting {@link module:comments/annotations/annotationsuis~AnnotationUI#activeAnnotation} in the appropriate
+ * {@link module:comments/annotations/annotationsuis~AnnotationsUI annotations UI} plugins.
+ *
+ * All active annotations are stored in {@link module:comments/annotations/annotations~Annotations#activeAnnotations}.
+ *
+ * `Annotations` is linked with {@link module:comments/annotations/annotationsuis~AnnotationsUIs}, which listens to events fired by
+ * `Annotations` and propagates information to and from annotations UI plugins.
+ */
+export default class Annotations extends ContextPlugin {
+    /**
+     * A set of currently active annotations.
+     *
+     * @observable
+     */
+    activeAnnotations: Set<Annotation>;
+    /**
+     * A collection of all annotations. It should not be operated on directly.
+     */
+    readonly collection: AnnotationCollection;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "Annotations";
+    /**
+     * @inheritDoc
+     */
+    constructor(context: Context | Editor);
+    /**
+     * Adds an annotation to the collection.
+     */
+    add(annotation: Annotation): void;
+    /**
+     * Removes the given annotation from the collection.
+     */
+    remove(annotation: Annotation): void;
+    /**
+     * Refreshes the visibility of annotations based on the visibility of their annotation targets.
+     *
+     * This method should be called when one or more annotations' targets changed their visibility,
+     * for example when one of the editors was shown or hidden.
+     *
+     * This method recalculates all annotations' {@link module:comments/annotations/annotation~Annotation#isVisible `isVisible`} property.
+     */
+    refreshVisibility(): void;
+    /**
+     * Refreshes the positioning of all visible annotations and sorts them topmost and leftmost.
+     */
+    refreshPositioning(): void;
+    /**
+     * Returns the annotation that "contains" the given annotation view's inner view.
+     */
+    getByInnerView(innerView: View): Annotation | undefined;
+    /**
+     * Deactivates all active annotations.
+     *
+     * @fires _deactivateAllAnnotations
+     */
+    deactivateAll(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * Activates the given annotation.
+     *
+     * If annotations UI that handles the given annotation already has an active annotation,
+     * then it deactivates it and activates the provided one.
+     *
+     * @fires _activateAnnotation
+     */
+    activate(annotation: Annotation): void;
+    /**
+     * Creates an annotation.
+     *
+     * ```ts
+     * const annotationView = annotations.createAnnotationView( editor.locale, innerView );
+     *
+     * const annotation = annotations.createAnnotation( {
+     * 	view: annotationView,
+     * 	target: document.getElementById( 'target' ),
+     * 	type: 'comment'
+     * } );
+     * ```
+     *
+     * @returns An annotation.
+     */
+    createAnnotation(options: AnnotationOptions): Annotation;
+    /**
+     * Creates an annotation view wrapper for the annotation content.
+     *
+     * ```ts
+     * const innerView = createCustomView();
+     * const annotationView = annotations.createAnnotationView( editor.locale, innerView );
+     * ```
+     *
+     * @returns An annotation view.
+     */
+    createAnnotationView(locale: Locale, view: AnnotationMainView): AnnotationView;
+}
+/**
+ * The configuration options which are used to create new {@link module:comments/annotations/annotation~Annotation annotations}.
+ *
+ * @param view The annotation view.
+ * @param target The annotation target.
+ * @param type The annotation type.
+ * @param isVisible The initial visibility of the annotation.
+ */
+export interface AnnotationOptions {
+    view: AnnotationView;
+    target: AnnotationTarget;
+    type: string | (() => string);
+    isVisible?: boolean;
+}
+/**
+ * An internal event that fires when the annotation should be activated.
+ *
+ * @eventName ~Annotations#_activateAnnotation
+ */
+export type ActivateAnnotationEvent = {
+    name: '_activateAnnotation';
+    args: [annotation: Annotation];
+};
+/**
+ * An internal event that fires when all annotations should be deactivated.
+ *
+ * @eventName ~Annotations#_deactivateAllAnnotations
+ */
+export type DeactivateAllAnnotationsEvent = {
+    name: '_deactivateAllAnnotations';
+    args: [];
+};

package/src/annotations/annotations.js

@@ -20,4 +20,4 @@
  *
  *
  */
-const _0x3ef3=['focusTracker','_activateAnnotation','activate','pluginName','remove','element','fire','has','view','_visibleAnnotations','stopListening','change:isVisible','delete','_bindAnnotationsToVisibleAnnotations','set','getByInnerView','refreshVisibility','createAnnotation','activeAnnotations','deactivateAll','collection','_deactivateAllAnnotations','refreshPositioning','Annotations','destroy','isVisible','add','_addActiveAnnotation','listenTo'];(function(_0x44be8a,_0x3ef349){const _0x3cdf36=function(_0x1ae04c){while(--_0x1ae04c){_0x44be8a['push'](_0x44be8a['shift']());}};_0x3cdf36(++_0x3ef349);}(_0x3ef3,0x185));const _0x3cdf=function(_0x44be8a,_0x3ef349){_0x44be8a=_0x44be8a-0x0;let _0x3cdf36=_0x3ef3[_0x44be8a];return _0x3cdf36;};import{ContextPlugin as _0x412276}from'ckeditor5/src/core';import _0x50a871 from'./annotation';import _0x3d4cad from'./annotationcollection';import _0x49d498 from'./view/annotationview';export default class b extends _0x412276{static get[_0x3cdf('0x14')](){return _0x3cdf('0xb');}constructor(_0x4f2fe6){super(_0x4f2fe6),this[_0x3cdf('0x8')]=new _0x3d4cad(),this[_0x3cdf('0x1a')]=new _0x3d4cad(),this[_0x3cdf('0x2')](_0x3cdf('0x6'),new Set()),this[_0x3cdf('0x1')]();}['add'](_0xfe5309){this['collection'][_0x3cdf('0xe')](_0xfe5309);}[_0x3cdf('0x15')](_0x1028cb){this[_0x3cdf('0x8')][_0x3cdf('0x15')](_0x1028cb),_0x1028cb[_0x3cdf('0xc')]();}[_0x3cdf('0x4')](){for(const _0xe984ef of this[_0x3cdf('0x8')])_0xe984ef[_0x3cdf('0x4')]();}[_0x3cdf('0xa')](){this[_0x3cdf('0x1a')]['refreshPositioning']();}[_0x3cdf('0x3')](_0x5c1648){return this[_0x3cdf('0x8')][_0x3cdf('0x3')](_0x5c1648);}[_0x3cdf('0x7')](){this[_0x3cdf('0x17')](_0x3cdf('0x9'));}[_0x3cdf('0xc')](){for(const _0xe5110a of this[_0x3cdf('0x8')])_0xe5110a[_0x3cdf('0xc')]();this['_visibleAnnotations'][_0x3cdf('0xc')](),this[_0x3cdf('0x8')]['destroy'](),super[_0x3cdf('0xc')]();}[_0x3cdf('0x13')](_0x198da2){this[_0x3cdf('0x17')](_0x3cdf('0x12'),_0x198da2);}[_0x3cdf('0x5')](_0x381fa7){return new _0x50a871(_0x381fa7);}['createAnnotationView'](_0x1c4690,_0x2e1e8d){return new _0x49d498(_0x1c4690,_0x2e1e8d);}[_0x3cdf('0xf')](_0x55f747){const _0x2b1eb7=new Set(this['activeAnnotations']);_0x2b1eb7[_0x3cdf('0xe')](_0x55f747),this[_0x3cdf('0x6')]=_0x2b1eb7;}['_removeActiveAnnotation'](_0x11cc41){const _0x2a1466=new Set(this[_0x3cdf('0x6')]);_0x2a1466[_0x3cdf('0x0')](_0x11cc41),this[_0x3cdf('0x6')]=_0x2a1466;}[_0x3cdf('0x1')](){const _0x5f14dd=this[_0x3cdf('0x8')],_0x3b9e58=this['_visibleAnnotations'];function _0x4cc03a(_0x8cd276){const _0x23b968=_0x8cd276['source'];_0x23b968[_0x3cdf('0xd')]&&!_0x3b9e58[_0x3cdf('0x18')](_0x23b968)?_0x3b9e58['add'](_0x23b968):!_0x23b968['isVisible']&&_0x3b9e58['has'](_0x23b968)&&_0x3b9e58[_0x3cdf('0x15')](_0x23b968),_0x23b968[_0x3cdf('0x19')][_0x3cdf('0x11')]['remove'](_0x23b968[_0x3cdf('0x19')][_0x3cdf('0x16')]),_0x23b968[_0x3cdf('0x19')]['focusTracker'][_0x3cdf('0xe')](_0x23b968[_0x3cdf('0x19')][_0x3cdf('0x16')]);}this['listenTo'](_0x5f14dd,_0x3cdf('0xe'),(_0x5cecfa,_0x12f230)=>{_0x12f230['isVisible']&&_0x3b9e58['add'](_0x12f230),this[_0x3cdf('0x10')](_0x12f230,'change:isVisible',_0x4cc03a);}),this[_0x3cdf('0x10')](_0x5f14dd,'remove',(_0x5cd805,_0x582a2c)=>{_0x3b9e58[_0x3cdf('0x18')](_0x582a2c)&&_0x3b9e58[_0x3cdf('0x15')](_0x582a2c),this[_0x3cdf('0x1b')](_0x582a2c,_0x3cdf('0x1c'),_0x4cc03a);});}}
+const _0xab17=['focusTracker','_removeActiveAnnotation','change:isVisible','_deactivateAllAnnotations','createAnnotation','pluginName','createAnnotationView','set','isVisible','getByInnerView','refreshPositioning','element','deactivateAll','listenTo','_activateAnnotation','collection','Annotations','add','delete','fire','view','remove','refreshVisibility','has','_bindAnnotationsToVisibleAnnotations','destroy','source','_addActiveAnnotation','activeAnnotations','_visibleAnnotations'];(function(_0x5c9264,_0xab1730){const _0x50b19e=function(_0x3e96c2){while(--_0x3e96c2){_0x5c9264['push'](_0x5c9264['shift']());}};_0x50b19e(++_0xab1730);}(_0xab17,0x1e9));const _0x50b1=function(_0x5c9264,_0xab1730){_0x5c9264=_0x5c9264-0x0;let _0x50b19e=_0xab17[_0x5c9264];return _0x50b19e;};import{ContextPlugin as _0x51097d}from'ckeditor5/src/core';import _0x43ff16 from'./annotation';import _0x1d4d19 from'./annotationcollection';import _0x260d34 from'./view/annotationview';export default class b extends _0x51097d{static get[_0x50b1('0x1a')](){return _0x50b1('0x7');}constructor(_0x285e48){super(_0x285e48),this[_0x50b1('0x6')]=new _0x1d4d19(),this['_visibleAnnotations']=new _0x1d4d19(),this[_0x50b1('0x1c')]('activeAnnotations',new Set()),this[_0x50b1('0xf')]();}[_0x50b1('0x8')](_0x48de32){this['collection'][_0x50b1('0x8')](_0x48de32);}[_0x50b1('0xc')](_0x3700b3){this[_0x50b1('0x6')][_0x50b1('0xc')](_0x3700b3),_0x3700b3[_0x50b1('0x10')]();}[_0x50b1('0xd')](){for(const _0x1ffcd9 of this[_0x50b1('0x6')])_0x1ffcd9[_0x50b1('0xd')]();}[_0x50b1('0x1')](){this['_visibleAnnotations'][_0x50b1('0x1')]();}[_0x50b1('0x0')](_0xc1330e){return this[_0x50b1('0x6')]['getByInnerView'](_0xc1330e);}[_0x50b1('0x3')](){this[_0x50b1('0xa')](_0x50b1('0x18'));}[_0x50b1('0x10')](){for(const _0x1b3e2a of this['collection'])_0x1b3e2a['destroy']();this['_visibleAnnotations'][_0x50b1('0x10')](),this[_0x50b1('0x6')]['destroy'](),super[_0x50b1('0x10')]();}['activate'](_0x2813a6){this[_0x50b1('0xa')](_0x50b1('0x5'),_0x2813a6);}[_0x50b1('0x19')](_0x2736ac){return new _0x43ff16(_0x2736ac);}[_0x50b1('0x1b')](_0x5a0c97,_0x1f7176){return new _0x260d34(_0x5a0c97,_0x1f7176);}[_0x50b1('0x12')](_0x3fb498){const _0x147848=new Set(this[_0x50b1('0x13')]);_0x147848[_0x50b1('0x8')](_0x3fb498),this[_0x50b1('0x13')]=_0x147848;}[_0x50b1('0x16')](_0x57b9c4){const _0x24b807=new Set(this['activeAnnotations']);_0x24b807[_0x50b1('0x9')](_0x57b9c4),this['activeAnnotations']=_0x24b807;}[_0x50b1('0xf')](){const _0x5f03e1=this[_0x50b1('0x6')],_0x383016=this[_0x50b1('0x14')];function _0x5f0b7e(_0x471d4f){const _0x50aae7=_0x471d4f[_0x50b1('0x11')];_0x50aae7[_0x50b1('0x1d')]&&!_0x383016[_0x50b1('0xe')](_0x50aae7)?_0x383016[_0x50b1('0x8')](_0x50aae7):!_0x50aae7[_0x50b1('0x1d')]&&_0x383016[_0x50b1('0xe')](_0x50aae7)&&_0x383016[_0x50b1('0xc')](_0x50aae7),_0x50aae7[_0x50b1('0xb')][_0x50b1('0x15')][_0x50b1('0xc')](_0x50aae7[_0x50b1('0xb')][_0x50b1('0x2')]),_0x50aae7['view'][_0x50b1('0x15')]['add'](_0x50aae7[_0x50b1('0xb')][_0x50b1('0x2')]);}this[_0x50b1('0x4')](_0x5f03e1,_0x50b1('0x8'),(_0x402504,_0x3c9708)=>{_0x3c9708['isVisible']&&_0x383016[_0x50b1('0x8')](_0x3c9708),this[_0x50b1('0x4')](_0x3c9708,'change:isVisible',_0x5f0b7e);}),this[_0x50b1('0x4')](_0x5f03e1,_0x50b1('0xc'),(_0x3b0e29,_0x1d8716)=>{_0x383016[_0x50b1('0xe')](_0x1d8716)&&_0x383016['remove'](_0x1d8716),this['stopListening'](_0x1d8716,_0x50b1('0x17'),_0x5f0b7e);});}}