@ckeditor/ckeditor5-link 46.0.0-alpha.0 → 46.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-link",
-  "version": "46.0.0-alpha.0",
+  "version": "46.0.0-alpha.2",
   "description": "Link feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,16 +13,16 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-clipboard": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-core": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-engine": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-icons": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-image": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-typing": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-ui": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-utils": "46.0.0-alpha.0",
-    "@ckeditor/ckeditor5-widget": "46.0.0-alpha.0",
-    "ckeditor5": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-clipboard": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-core": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-engine": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-icons": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-image": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-typing": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-ui": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-utils": "46.0.0-alpha.2",
+    "@ckeditor/ckeditor5-widget": "46.0.0-alpha.2",
+    "ckeditor5": "46.0.0-alpha.2",
     "es-toolkit": "1.39.5"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/index.d.ts

@@ -25,7 +25,7 @@ export type { LinkProvidersCancelEvent } from './ui/linkprovideritemsview.js';
 export type { LinkFormValidatorCallback, LinkFormSubmitEvent, LinkFormCancelEvent } from './ui/linkformview.js';
 export { addLinkProtocolIfApplicable, ensureSafeUrl, ensureSafeUrl as _ensureSafeLinkUrl, isLinkableElement, isLinkElement, LINK_KEYSTROKE as _LINK_KEYSTROKE, createLinkElement as _createLinkElement, getLocalizedDecorators as _getLocalizedLinkDecorators, normalizeDecorators as _normalizeLinkDecorators, isEmail as _isEmailLink, linkHasProtocol as _hasLinkProtocol, openLink as _openLink, extractTextFromLinkRange as _extractTextFromLinkRange } from './utils.js';
 export type { NormalizedLinkDecoratorAutomaticDefinition, NormalizedLinkDecoratorManualDefinition, NormalizedLinkDecoratorDefinition } from './utils.js';
-export { AutomaticDecorators } from './utils/automaticdecorators.js';
+export { AutomaticLinkDecorators } from './utils/automaticdecorators.js';
 export { LinkManualDecorator } from './utils/manualdecorator.js';
 export type { LinkConfig, LinkDecoratorDefinition, LinkDecoratorAutomaticDefinition, LinkDecoratorManualDefinition } from './linkconfig.js';
 import './augmentation.js';

package/src/index.js

@@ -20,6 +20,6 @@ export { LinkPreviewButtonView as _LinkPreviewButtonView } from './ui/linkprevie
 export { LinkPropertiesView } from './ui/linkpropertiesview.js';
 export { LinkProviderItemsView } from './ui/linkprovideritemsview.js';
 export { addLinkProtocolIfApplicable, ensureSafeUrl, ensureSafeUrl as _ensureSafeLinkUrl, isLinkableElement, isLinkElement, LINK_KEYSTROKE as _LINK_KEYSTROKE, createLinkElement as _createLinkElement, getLocalizedDecorators as _getLocalizedLinkDecorators, normalizeDecorators as _normalizeLinkDecorators, isEmail as _isEmailLink, linkHasProtocol as _hasLinkProtocol, openLink as _openLink, extractTextFromLinkRange as _extractTextFromLinkRange } from './utils.js';
-export { AutomaticDecorators } from './utils/automaticdecorators.js';
+export { AutomaticLinkDecorators } from './utils/automaticdecorators.js';
 export { LinkManualDecorator } from './utils/manualdecorator.js';
 import './augmentation.js';

package/src/linkcommand.d.ts

@@ -7,7 +7,7 @@
  */
 import { Command } from 'ckeditor5/src/core.js';
 import { Collection } from 'ckeditor5/src/utils.js';
-import { AutomaticDecorators } from './utils/automaticdecorators.js';
+import { AutomaticLinkDecorators } from './utils/automaticdecorators.js';
 import { type LinkManualDecorator } from './utils/manualdecorator.js';
 /**
  * The link command. It is used by the {@link module:link/link~Link link feature}.
@@ -31,7 +31,7 @@ export declare class LinkCommand extends Command {
      * An instance of the helper that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition}
      * that are used by the {@glink features/link link} and the {@glink features/images/images-linking linking images} features.
      */
-    readonly automaticDecorators: AutomaticDecorators;
+    readonly automaticDecorators: AutomaticLinkDecorators;
     /**
      * Synchronizes the state of {@link #manualDecorators} with the currently present elements in the model.
      */

package/src/linkcommand.js

@@ -9,7 +9,7 @@ import { Command } from 'ckeditor5/src/core.js';
 import { findAttributeRange } from 'ckeditor5/src/typing.js';
 import { Collection, diff, first, toMap } from 'ckeditor5/src/utils.js';
 import { ModelLivePosition } from 'ckeditor5/src/engine.js';
-import { AutomaticDecorators } from './utils/automaticdecorators.js';
+import { AutomaticLinkDecorators } from './utils/automaticdecorators.js';
 import { extractTextFromLinkRange, isLinkableElement } from './utils.js';
 /**
  * The link command. It is used by the {@link module:link/link~Link link feature}.
@@ -26,7 +26,7 @@ export class LinkCommand extends Command {
      * An instance of the helper that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition}
      * that are used by the {@glink features/link link} and the {@glink features/images/images-linking linking images} features.
      */
-    automaticDecorators = new AutomaticDecorators();
+    automaticDecorators = new AutomaticLinkDecorators();
     /**
      * Synchronizes the state of {@link #manualDecorators} with the currently present elements in the model.
      */

package/src/linkediting.d.ts

@@ -51,7 +51,7 @@ export declare class LinkEditing extends Plugin {
      * Processes an array of configured {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}
      * and registers a {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher downcast dispatcher}
      * for each one of them. Downcast dispatchers are obtained using the
-     * {@link module:link/utils/automaticdecorators~AutomaticDecorators#getDispatcher} method.
+     * {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators#getDispatcher} method.
      *
      * **Note**: This method also activates the automatic external link decorator if enabled with
      * {@link module:link/linkconfig~LinkConfig#addTargetToExternalLinks `config.link.addTargetToExternalLinks`}.

package/src/linkediting.js

@@ -119,7 +119,7 @@ export class LinkEditing extends Plugin {
      * Processes an array of configured {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}
      * and registers a {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher downcast dispatcher}
      * for each one of them. Downcast dispatchers are obtained using the
-     * {@link module:link/utils/automaticdecorators~AutomaticDecorators#getDispatcher} method.
+     * {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators#getDispatcher} method.
      *
      * **Note**: This method also activates the automatic external link decorator if enabled with
      * {@link module:link/linkconfig~LinkConfig#addTargetToExternalLinks `config.link.addTargetToExternalLinks`}.

package/src/utils/automaticdecorators.d.ts

@@ -12,14 +12,14 @@ import type { NormalizedLinkDecoratorAutomaticDefinition } from '../utils.js';
  * Helper class that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition} and provides
  * the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement downcast dispatchers} for them.
  */
-export declare class AutomaticDecorators {
+export declare class AutomaticLinkDecorators {
     /**
      * Stores the definition of {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}.
      * This data is used as a source for a downcast dispatcher to create a proper conversion to output data.
      */
     private _definitions;
     /**
-     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticDecorators}
+     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators}
      * instance.
      */
     get length(): number;

package/src/utils/automaticdecorators.js

@@ -10,14 +10,14 @@ import { toMap } from 'ckeditor5/src/utils.js';
  * Helper class that ties together all {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition} and provides
  * the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#attributeToElement downcast dispatchers} for them.
  */
-export class AutomaticDecorators {
+export class AutomaticLinkDecorators {
     /**
      * Stores the definition of {@link module:link/linkconfig~LinkDecoratorAutomaticDefinition automatic decorators}.
      * This data is used as a source for a downcast dispatcher to create a proper conversion to output data.
      */
     _definitions = new Set();
     /**
-     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticDecorators}
+     * Gives information about the number of decorators stored in the {@link module:link/utils/automaticdecorators~AutomaticLinkDecorators}
      * instance.
      */
     get length() {

package/src/utils.d.ts

@@ -40,11 +40,14 @@ export declare function ensureSafeUrl(url: unknown, allowedProtocols?: Array<str
  *
  * @param t Shorthand for {@link module:utils/locale~Locale#t Locale#t}.
  * @param decorators The decorator reference where the label values should be localized.
+ * @internal
  */
 export declare function getLocalizedDecorators(t: LocaleTranslate, decorators: Array<NormalizedLinkDecoratorDefinition>): Array<NormalizedLinkDecoratorDefinition>;
 /**
  * Converts an object with defined decorators to a normalized array of decorators. The `id` key is added for each decorator and
  * is used as the attribute's name in the model.
+ *
+ * @internal
  */
 export declare function normalizeDecorators(decorators?: Record<string, LinkDecoratorDefinition>): Array<NormalizedLinkDecoratorDefinition>;
 /**
@@ -53,6 +56,8 @@ export declare function normalizeDecorators(decorators?: Record<string, LinkDeco
 export declare function isLinkableElement(element: ModelElement | null, schema: ModelSchema): element is ModelElement;
 /**
  * Returns `true` if the specified `value` is an email.
+ *
+ * @internal
  */
 export declare function isEmail(value: string): boolean;
 /**
@@ -65,6 +70,8 @@ export declare function isEmail(value: string): boolean;
 export declare function addLinkProtocolIfApplicable(link: string, defaultProtocol?: string): string;
 /**
  * Checks if protocol is already included in the link.
+ *
+ * @internal
  */
 export declare function linkHasProtocol(link: string): boolean;
 /**

package/src/utils.js

@@ -66,6 +66,7 @@ function isSafeUrl(url, customRegexp) {
  *
  * @param t Shorthand for {@link module:utils/locale~Locale#t Locale#t}.
  * @param decorators The decorator reference where the label values should be localized.
+ * @internal
  */
 export function getLocalizedDecorators(t, decorators) {
     const localizedDecoratorsLabels = {
@@ -83,6 +84,8 @@ export function getLocalizedDecorators(t, decorators) {
 /**
  * Converts an object with defined decorators to a normalized array of decorators. The `id` key is added for each decorator and
  * is used as the attribute's name in the model.
+ *
+ * @internal
  */
 export function normalizeDecorators(decorators) {
     const retArray = [];
@@ -105,6 +108,8 @@ export function isLinkableElement(element, schema) {
 }
 /**
  * Returns `true` if the specified `value` is an email.
+ *
+ * @internal
  */
 export function isEmail(value) {
     return EMAIL_REG_EXP.test(value);
@@ -123,6 +128,8 @@ export function addLinkProtocolIfApplicable(link, defaultProtocol) {
 }
 /**
  * Checks if protocol is already included in the link.
+ *
+ * @internal
  */
 export function linkHasProtocol(link) {
     return PROTOCOL_REG_EXP.test(link);