@ckeditor/ckeditor5-language 35.4.0 → 36.0.0

package/LICENSE.md

@@ -2,7 +2,7 @@ Software License Agreement
 ==========================
 
 **CKEditor 5 text part language feature** – https://github.com/ckeditor/ckeditor5-language <br>
-Copyright (c) 2003-2022, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
+Copyright (c) 2003-2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
 
 Licensed under the terms of [GNU General Public License Version 2 or later](http://www.gnu.org/licenses/gpl.html).
 

package/build/language.js

@@ -1,5 +1,5 @@
 !function(e){const t=e.en=e.en||{};t.dictionary=Object.assign(t.dictionary||{},{"Choose language":"Choose language",Language:"Language","Remove language":"Remove language"})}(window.CKEDITOR_TRANSLATIONS||(window.CKEDITOR_TRANSLATIONS={})),
 /*!
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
- */(()=>{var e={176:(e,t,n)=>{"use strict";n.d(t,{Z:()=>o});var a=n(609),r=n.n(a)()((function(e){return e[1]}));r.push([e.id,".ck-content span[lang]{font-style:italic}",""]);const o=r},609:e=>{"use strict";e.exports=function(e){var t=[];return t.toString=function(){return this.map((function(t){var n=e(t);return t[2]?"@media ".concat(t[2]," {").concat(n,"}"):n})).join("")},t.i=function(e,n,a){"string"==typeof e&&(e=[[null,e,""]]);var r={};if(a)for(var o=0;o<this.length;o++){var i=this[o][0];null!=i&&(r[i]=!0)}for(var s=0;s<e.length;s++){var u=[].concat(e[s]);a&&r[u[0]]||(n&&(u[2]?u[2]="".concat(n," and ").concat(u[2]):u[2]=n),t.push(u))}},t}},62:(e,t,n)=>{"use strict";var a,r=function(){return void 0===a&&(a=Boolean(window&&document&&document.all&&!window.atob)),a},o=function(){var e={};return function(t){if(void 0===e[t]){var n=document.querySelector(t);if(window.HTMLIFrameElement&&n instanceof window.HTMLIFrameElement)try{n=n.contentDocument.head}catch(e){n=null}e[t]=n}return e[t]}}(),i=[];function s(e){for(var t=-1,n=0;n<i.length;n++)if(i[n].identifier===e){t=n;break}return t}function u(e,t){for(var n={},a=[],r=0;r<e.length;r++){var o=e[r],u=t.base?o[0]+t.base:o[0],l=n[u]||0,c="".concat(u," ").concat(l);n[u]=l+1;var d=s(c),g={css:o[1],media:o[2],sourceMap:o[3]};-1!==d?(i[d].references++,i[d].updater(g)):i.push({identifier:c,updater:h(g,t),references:1}),a.push(c)}return a}function l(e){var t=document.createElement("style"),a=e.attributes||{};if(void 0===a.nonce){var r=n.nc;r&&(a.nonce=r)}if(Object.keys(a).forEach((function(e){t.setAttribute(e,a[e])})),"function"==typeof e.insert)e.insert(t);else{var i=o(e.insert||"head");if(!i)throw new Error("Couldn't find a style target. This probably means that the value for the 'insert' parameter is invalid.");i.appendChild(t)}return t}var c,d=(c=[],function(e,t){return c[e]=t,c.filter(Boolean).join("\n")});function g(e,t,n,a){var r=n?"":a.media?"@media ".concat(a.media," {").concat(a.css,"}"):a.css;if(e.styleSheet)e.styleSheet.cssText=d(t,r);else{var o=document.createTextNode(r),i=e.childNodes;i[t]&&e.removeChild(i[t]),i.length?e.insertBefore(o,i[t]):e.appendChild(o)}}function f(e,t,n){var a=n.css,r=n.media,o=n.sourceMap;if(r?e.setAttribute("media",r):e.removeAttribute("media"),o&&"undefined"!=typeof btoa&&(a+="\n/*# sourceMappingURL=data:application/json;base64,".concat(btoa(unescape(encodeURIComponent(JSON.stringify(o))))," */")),e.styleSheet)e.styleSheet.cssText=a;else{for(;e.firstChild;)e.removeChild(e.firstChild);e.appendChild(document.createTextNode(a))}}var m=null,p=0;function h(e,t){var n,a,r;if(t.singleton){var o=p++;n=m||(m=l(t)),a=g.bind(null,n,o,!1),r=g.bind(null,n,o,!0)}else n=l(t),a=f.bind(null,n,t),r=function(){!function(e){if(null===e.parentNode)return!1;e.parentNode.removeChild(e)}(n)};return a(e),function(t){if(t){if(t.css===e.css&&t.media===e.media&&t.sourceMap===e.sourceMap)return;a(e=t)}else r()}}e.exports=function(e,t){(t=t||{}).singleton||"boolean"==typeof t.singleton||(t.singleton=r());var n=u(e=e||[],t);return function(e){if(e=e||[],"[object Array]"===Object.prototype.toString.call(e)){for(var a=0;a<n.length;a++){var r=s(n[a]);i[r].references--}for(var o=u(e,t),l=0;l<n.length;l++){var c=s(n[l]);0===i[c].references&&(i[c].updater(),i.splice(c,1))}n=o}}}},704:(e,t,n)=>{e.exports=n(79)("./src/core.js")},273:(e,t,n)=>{e.exports=n(79)("./src/ui.js")},209:(e,t,n)=>{e.exports=n(79)("./src/utils.js")},79:e=>{"use strict";e.exports=CKEditor5.dll}},t={};function n(a){var r=t[a];if(void 0!==r)return r.exports;var o=t[a]={id:a,exports:{}};return e[a](o,o.exports,n),o.exports}n.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return n.d(t,{a:t}),t},n.d=(e,t)=>{for(var a in t)n.o(t,a)&&!n.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:t[a]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.nc=void 0;var a={};(()=>{"use strict";n.r(a),n.d(a,{TextPartLanguage:()=>f,TextPartLanguageEditing:()=>i,TextPartLanguageUI:()=>g});var e=n(704),t=n(209);function r(e,n){return`${e}:${n=n||(0,t.getLanguageDirection)(e)}`}class o extends e.Command{refresh(){const e=this.editor.model,t=e.document;this.value=this._getValueFromFirstAllowedNode(),this.isEnabled=e.schema.checkAttributeInSelection(t.selection,"language")}execute({languageCode:e,textDirection:t}={}){const n=this.editor.model,a=n.document.selection,o=!!e&&r(e,t);n.change((e=>{if(a.isCollapsed)o?e.setSelectionAttribute("language",o):e.removeSelectionAttribute("language");else{const t=n.schema.getValidRanges(a.getRanges(),"language");for(const n of t)o?e.setAttribute("language",o,n):e.removeAttribute("language",n)}}))}_getValueFromFirstAllowedNode(){const e=this.editor.model,t=e.schema,n=e.document.selection;if(n.isCollapsed)return n.getAttribute("language")||!1;for(const e of n.getRanges())for(const n of e.getItems())if(t.checkAttribute(n,"language"))return n.getAttribute("language")||!1;return!1}}class i extends e.Plugin{static get pluginName(){return"TextPartLanguageEditing"}constructor(e){super(e),e.config.define("language",{textPartLanguage:[{title:"Arabic",languageCode:"ar"},{title:"French",languageCode:"fr"},{title:"Spanish",languageCode:"es"}]})}init(){const e=this.editor;e.model.schema.extend("$text",{allowAttributes:"language"}),e.model.schema.setAttributeProperties("language",{copyOnEnter:!0}),this._defineConverters(),e.commands.add("textPartLanguage",new o(e))}_defineConverters(){const e=this.editor.conversion;e.for("upcast").elementToAttribute({model:{key:"language",value:e=>r(e.getAttribute("lang"),e.getAttribute("dir"))},view:{name:"span",attributes:{lang:/[\s\S]+/}}}),e.for("downcast").attributeToElement({model:"language",view:(e,{writer:t},n)=>{if(!e)return;if(!n.item.is("$textProxy")&&!n.item.is("documentSelection"))return;const{languageCode:a,textDirection:r}=function(e){const[t,n]=e.split(":");return{languageCode:t,textDirection:n}}(e);return t.createAttributeElement("span",{lang:a,dir:r})}})}}var s=n(273),u=n(62),l=n.n(u),c=n(176),d={injectType:"singletonStyleTag",attributes:{"data-cke":!0},insert:"head",singleton:!0};l()(c.Z,d);c.Z.locals;class g extends e.Plugin{static get pluginName(){return"TextPartLanguageUI"}init(){const e=this.editor,n=e.t,a=e.config.get("language.textPartLanguage"),o=n("Choose language"),i=n("Remove language"),u=n("Language");e.ui.componentFactory.add("textPartLanguage",(n=>{const l=new t.Collection,c={},d=e.commands.get("textPartLanguage");l.add({type:"button",model:new s.Model({label:i,languageCode:!1,withText:!0})}),l.add({type:"separator"});for(const e of a){const t={type:"button",model:new s.Model({label:e.title,languageCode:e.languageCode,textDirection:e.textDirection,withText:!0})},n=r(e.languageCode,e.textDirection);t.model.bind("isOn").to(d,"value",(e=>e===n)),l.add(t),c[n]=e.title}const g=(0,s.createDropdown)(n);return(0,s.addListToDropdown)(g,l),g.buttonView.set({isOn:!1,withText:!0,tooltip:u}),g.extendTemplate({attributes:{class:["ck-text-fragment-language-dropdown"]}}),g.bind("isEnabled").to(d,"isEnabled"),g.buttonView.bind("label").to(d,"value",(e=>c[e]||o)),this.listenTo(g,"execute",(t=>{d.execute({languageCode:t.source.languageCode,textDirection:t.source.textDirection}),e.editing.view.focus()})),g}))}}class f extends e.Plugin{static get requires(){return[i,g]}static get pluginName(){return"TextPartLanguage"}}})(),(window.CKEditor5=window.CKEditor5||{}).language=a})();
+ */(()=>{var e={176:(e,t,n)=>{"use strict";n.d(t,{Z:()=>o});var a=n(609),r=n.n(a)()((function(e){return e[1]}));r.push([e.id,".ck-content span[lang]{font-style:italic}",""]);const o=r},609:e=>{"use strict";e.exports=function(e){var t=[];return t.toString=function(){return this.map((function(t){var n=e(t);return t[2]?"@media ".concat(t[2]," {").concat(n,"}"):n})).join("")},t.i=function(e,n,a){"string"==typeof e&&(e=[[null,e,""]]);var r={};if(a)for(var o=0;o<this.length;o++){var i=this[o][0];null!=i&&(r[i]=!0)}for(var s=0;s<e.length;s++){var u=[].concat(e[s]);a&&r[u[0]]||(n&&(u[2]?u[2]="".concat(n," and ").concat(u[2]):u[2]=n),t.push(u))}},t}},62:(e,t,n)=>{"use strict";var a,r=function(){return void 0===a&&(a=Boolean(window&&document&&document.all&&!window.atob)),a},o=function(){var e={};return function(t){if(void 0===e[t]){var n=document.querySelector(t);if(window.HTMLIFrameElement&&n instanceof window.HTMLIFrameElement)try{n=n.contentDocument.head}catch(e){n=null}e[t]=n}return e[t]}}(),i=[];function s(e){for(var t=-1,n=0;n<i.length;n++)if(i[n].identifier===e){t=n;break}return t}function u(e,t){for(var n={},a=[],r=0;r<e.length;r++){var o=e[r],u=t.base?o[0]+t.base:o[0],l=n[u]||0,c="".concat(u," ").concat(l);n[u]=l+1;var d=s(c),g={css:o[1],media:o[2],sourceMap:o[3]};-1!==d?(i[d].references++,i[d].updater(g)):i.push({identifier:c,updater:h(g,t),references:1}),a.push(c)}return a}function l(e){var t=document.createElement("style"),a=e.attributes||{};if(void 0===a.nonce){var r=n.nc;r&&(a.nonce=r)}if(Object.keys(a).forEach((function(e){t.setAttribute(e,a[e])})),"function"==typeof e.insert)e.insert(t);else{var i=o(e.insert||"head");if(!i)throw new Error("Couldn't find a style target. This probably means that the value for the 'insert' parameter is invalid.");i.appendChild(t)}return t}var c,d=(c=[],function(e,t){return c[e]=t,c.filter(Boolean).join("\n")});function g(e,t,n,a){var r=n?"":a.media?"@media ".concat(a.media," {").concat(a.css,"}"):a.css;if(e.styleSheet)e.styleSheet.cssText=d(t,r);else{var o=document.createTextNode(r),i=e.childNodes;i[t]&&e.removeChild(i[t]),i.length?e.insertBefore(o,i[t]):e.appendChild(o)}}function f(e,t,n){var a=n.css,r=n.media,o=n.sourceMap;if(r?e.setAttribute("media",r):e.removeAttribute("media"),o&&"undefined"!=typeof btoa&&(a+="\n/*# sourceMappingURL=data:application/json;base64,".concat(btoa(unescape(encodeURIComponent(JSON.stringify(o))))," */")),e.styleSheet)e.styleSheet.cssText=a;else{for(;e.firstChild;)e.removeChild(e.firstChild);e.appendChild(document.createTextNode(a))}}var m=null,p=0;function h(e,t){var n,a,r;if(t.singleton){var o=p++;n=m||(m=l(t)),a=g.bind(null,n,o,!1),r=g.bind(null,n,o,!0)}else n=l(t),a=f.bind(null,n,t),r=function(){!function(e){if(null===e.parentNode)return!1;e.parentNode.removeChild(e)}(n)};return a(e),function(t){if(t){if(t.css===e.css&&t.media===e.media&&t.sourceMap===e.sourceMap)return;a(e=t)}else r()}}e.exports=function(e,t){(t=t||{}).singleton||"boolean"==typeof t.singleton||(t.singleton=r());var n=u(e=e||[],t);return function(e){if(e=e||[],"[object Array]"===Object.prototype.toString.call(e)){for(var a=0;a<n.length;a++){var r=s(n[a]);i[r].references--}for(var o=u(e,t),l=0;l<n.length;l++){var c=s(n[l]);0===i[c].references&&(i[c].updater(),i.splice(c,1))}n=o}}}},704:(e,t,n)=>{e.exports=n(79)("./src/core.js")},273:(e,t,n)=>{e.exports=n(79)("./src/ui.js")},209:(e,t,n)=>{e.exports=n(79)("./src/utils.js")},79:e=>{"use strict";e.exports=CKEditor5.dll}},t={};function n(a){var r=t[a];if(void 0!==r)return r.exports;var o=t[a]={id:a,exports:{}};return e[a](o,o.exports,n),o.exports}n.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return n.d(t,{a:t}),t},n.d=(e,t)=>{for(var a in t)n.o(t,a)&&!n.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:t[a]})},n.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),n.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},n.nc=void 0;var a={};(()=>{"use strict";n.r(a),n.d(a,{TextPartLanguage:()=>f,TextPartLanguageEditing:()=>i,TextPartLanguageUI:()=>g});var e=n(704),t=n(209);function r(e,n){return`${e}:${n=n||(0,t.getLanguageDirection)(e)}`}class o extends e.Command{refresh(){const e=this.editor.model,t=e.document;this.value=this._getValueFromFirstAllowedNode(),this.isEnabled=e.schema.checkAttributeInSelection(t.selection,"language")}execute({languageCode:e,textDirection:t}={}){const n=this.editor.model,a=n.document.selection,o=!!e&&r(e,t);n.change((e=>{if(a.isCollapsed)o?e.setSelectionAttribute("language",o):e.removeSelectionAttribute("language");else{const t=n.schema.getValidRanges(a.getRanges(),"language");for(const n of t)o?e.setAttribute("language",o,n):e.removeAttribute("language",n)}}))}_getValueFromFirstAllowedNode(){const e=this.editor.model,t=e.schema,n=e.document.selection;if(n.isCollapsed)return n.getAttribute("language")||!1;for(const e of n.getRanges())for(const n of e.getItems())if(t.checkAttribute(n,"language"))return n.getAttribute("language")||!1;return!1}}class i extends e.Plugin{static get pluginName(){return"TextPartLanguageEditing"}constructor(e){super(e),e.config.define("language",{textPartLanguage:[{title:"Arabic",languageCode:"ar"},{title:"French",languageCode:"fr"},{title:"Spanish",languageCode:"es"}]})}init(){const e=this.editor;e.model.schema.extend("$text",{allowAttributes:"language"}),e.model.schema.setAttributeProperties("language",{copyOnEnter:!0}),this._defineConverters(),e.commands.add("textPartLanguage",new o(e))}_defineConverters(){const e=this.editor.conversion;e.for("upcast").elementToAttribute({model:{key:"language",value:e=>r(e.getAttribute("lang"),e.getAttribute("dir"))},view:{name:"span",attributes:{lang:/[\s\S]+/}}}),e.for("downcast").attributeToElement({model:"language",view:(e,{writer:t},n)=>{if(!e)return;if(!n.item.is("$textProxy")&&!n.item.is("documentSelection"))return;const{languageCode:a,textDirection:r}=function(e){const[t,n]=e.split(":");return{languageCode:t,textDirection:n}}(e);return t.createAttributeElement("span",{lang:a,dir:r})}})}}var s=n(273),u=n(62),l=n.n(u),c=n(176),d={injectType:"singletonStyleTag",attributes:{"data-cke":!0},insert:"head",singleton:!0};l()(c.Z,d);c.Z.locals;class g extends e.Plugin{static get pluginName(){return"TextPartLanguageUI"}init(){const e=this.editor,n=e.t,a=e.config.get("language.textPartLanguage"),o=n("Choose language"),i=n("Remove language"),u=n("Language");e.ui.componentFactory.add("textPartLanguage",(n=>{const l=new t.Collection,c={},d=e.commands.get("textPartLanguage");l.add({type:"button",model:new s.Model({label:i,languageCode:!1,withText:!0})}),l.add({type:"separator"});for(const e of a){const t={type:"button",model:new s.Model({label:e.title,languageCode:e.languageCode,textDirection:e.textDirection,withText:!0})},n=r(e.languageCode,e.textDirection);t.model.bind("isOn").to(d,"value",(e=>e===n)),l.add(t),c[n]=e.title}const g=(0,s.createDropdown)(n);return(0,s.addListToDropdown)(g,l),g.buttonView.set({isOn:!1,withText:!0,tooltip:u}),g.extendTemplate({attributes:{class:["ck-text-fragment-language-dropdown"]}}),g.bind("isEnabled").to(d,"isEnabled"),g.buttonView.bind("label").to(d,"value",(e=>e&&c[e]||o)),this.listenTo(g,"execute",(t=>{d.execute({languageCode:t.source.languageCode,textDirection:t.source.textDirection}),e.editing.view.focus()})),g}))}}class f extends e.Plugin{static get requires(){return[i,g]}static get pluginName(){return"TextPartLanguage"}}})(),(window.CKEditor5=window.CKEditor5||{}).language=a})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-language",
-  "version": "35.4.0",
+  "version": "36.0.0",
   "description": "Text part language feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,16 +12,17 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "^35.4.0"
+    "ckeditor5": "^36.0.0"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-core": "^35.4.0",
-    "@ckeditor/ckeditor5-dev-utils": "^31.0.0",
-    "@ckeditor/ckeditor5-editor-classic": "^35.4.0",
-    "@ckeditor/ckeditor5-engine": "^35.4.0",
-    "@ckeditor/ckeditor5-paragraph": "^35.4.0",
-    "@ckeditor/ckeditor5-theme-lark": "^35.4.0",
-    "@ckeditor/ckeditor5-ui": "^35.4.0",
+    "@ckeditor/ckeditor5-core": "^36.0.0",
+    "@ckeditor/ckeditor5-dev-utils": "^32.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^36.0.0",
+    "@ckeditor/ckeditor5-engine": "^36.0.0",
+    "@ckeditor/ckeditor5-paragraph": "^36.0.0",
+    "@ckeditor/ckeditor5-theme-lark": "^36.0.0",
+    "@ckeditor/ckeditor5-ui": "^36.0.0",
+    "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"
   },
@@ -40,13 +41,16 @@
   },
   "files": [
     "lang",
-    "src",
+    "src/**/*.js",
+    "src/**/*.d.ts",
     "theme",
     "build",
     "ckeditor5-metadata.json",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "dll:build": "webpack"
+    "dll:build": "webpack",
+    "build": "tsc -p ./tsconfig.release.json",
+    "postversion": "npm run build"
   }
 }

package/src/index.js

@@ -1,12 +1,10 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module language
  */
-
 export { default as TextPartLanguage } from './textpartlanguage';
 export { default as TextPartLanguageEditing } from './textpartlanguageediting';
 export { default as TextPartLanguageUI } from './textpartlanguageui';

package/src/textpartlanguage.js

@@ -1,17 +1,10 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
-/**
- * @module language/textpartlanguage
- */
-
 import { Plugin } from 'ckeditor5/src/core';
-
 import TextPartLanguageEditing from './textpartlanguageediting';
 import TextPartLanguageUI from './textpartlanguageui';
-
 /**
  * The text part language feature.
  *
@@ -26,61 +19,18 @@ import TextPartLanguageUI from './textpartlanguageui';
  * This is a "glue" plugin which loads the
  * {@link module:language/textpartlanguageediting~TextPartLanguageEditing text part language editing feature}
  * and the {@link module:language/textpartlanguageui~TextPartLanguageUI text part language UI feature}.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class TextPartLanguage extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ TextPartLanguageEditing, TextPartLanguageUI ];
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'TextPartLanguage';
-	}
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [TextPartLanguageEditing, TextPartLanguageUI];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TextPartLanguage';
+    }
 }
-
-/**
- * The available {@link module:language/textpartlanguage~TextPartLanguage}
- * options that allow setting the language of parts of the content.
- *
- * This configuration option is available only with the {@glink api/language text part language feature} enabled.
- *
- * Refer to [WCAG 3.1.2 Language of Parts](https://www.w3.org/TR/UNDERSTANDING-WCAG20/meaning-other-lang-id.html) specification
- * to learn more.
- *
- * To change the editor's UI language, refer to the {@glink features/ui-language Setting the UI language} guide.
- *
- * The default value is:
- *
- *		const config = [
- *			{ title: 'Arabic', languageCode: 'ar' },
- *			{ title: 'French', languageCode: 'fr' },
- *			{ title: 'Spanish', languageCode: 'es' }
- *		];
- *
- * The `title` property will be used by the text part language dropdown to render available options.
- *
- * The `languageCode` property is used for the `lang` attribute in [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
- *
- * You can also specify the optional `textDirection` property indicating the reading direction of the language.
- * Correct values are `ltr` and `rtl`. When the `textDirection` property is missing, the text part language feature will
- * specify the text direction by itself.
- *
- * @member {Array.<module:language/textpartlanguage~TextPartLanguageOption>}
- * module:core/editor/editorconfig~LanguageConfig#textPartLanguage
- */
-
-/**
- * The text part language feature option descriptor.
- *
- * @typedef {Object} module:language/textpartlanguage~TextPartLanguageOption
- * @property {String} title The user-readable title of the option.
- * @property {String} languageCode The language code in the ISO 639 format.
- * @property {'ltr'|'rtl'} [textDirection] The language text direction. Automatically detected if omitted.
- */

package/src/textpartlanguagecommand.js

@@ -1,124 +1,89 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
-/**
- * @module language/textpartlanguagecommand
- */
-
 import { Command } from 'ckeditor5/src/core';
 import { stringifyLanguageAttribute } from './utils';
-
 /**
  * The text part language command plugin.
- *
- * @extends module:core/command~Command
  */
 export default class TextPartLanguageCommand extends Command {
-	/**
-	 * If the selection starts in a language attribute, the value is set to
-	 * the value of that language in a format:
-	 *
-	 *		<languageCode>:<textDirection>
-	 *
-	 * * `languageCode` - The language code used for the `lang` attribute in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1)
-	 *    format.
-	 * * `textDirection` - One of the following values: `rtl` or `ltr`, indicating the reading direction of the language.
-	 *
-	 * See the {@link module:core/editor/editorconfig~LanguageConfig#textPartLanguage text part language configuration}
-	 * for more information about language properties.
-	 *
-	 * It is set to `false` otherwise.
-	 *
-	 * @observable
-	 * @readonly
-	 * @member {Boolean|String} #value
-	 */
-
-	/**
-	 * @inheritDoc
-	 */
-	refresh() {
-		const model = this.editor.model;
-		const doc = model.document;
-
-		this.value = this._getValueFromFirstAllowedNode();
-		this.isEnabled = model.schema.checkAttributeInSelection( doc.selection, 'language' );
-	}
-
-	/**
-	 * Executes the command. Applies the attribute to the selection or removes it from the selection.
-	 *
-	 * If `languageCode` is set to `false` or a `null` value, it will remove attributes. Otherwise, it will set
-	 * the attribute in the `{@link #value value}` format.
-	 *
-	 * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
-	 *
-	 * * If the selection is on a range, the command applies the attribute to all nodes in that range
-	 * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
-	 * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
-	 * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
-	 * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
-	 * that the selection inherits all attributes from a node if it is in an empty node).
-	 *
-	 * @fires execute
-	 * @param {Object} [options] Command options.
-	 * @param {String|Boolean} [options.languageCode] The language code to be applied to the model.
-	 * @param {String} [options.textDirection] The language text direction.
-	 */
-	execute( { languageCode, textDirection } = {} ) {
-		const model = this.editor.model;
-		const doc = model.document;
-		const selection = doc.selection;
-
-		const value = languageCode ? stringifyLanguageAttribute( languageCode, textDirection ) : false;
-
-		model.change( writer => {
-			if ( selection.isCollapsed ) {
-				if ( value ) {
-					writer.setSelectionAttribute( 'language', value );
-				} else {
-					writer.removeSelectionAttribute( 'language' );
-				}
-			} else {
-				const ranges = model.schema.getValidRanges( selection.getRanges(), 'language' );
-
-				for ( const range of ranges ) {
-					if ( value ) {
-						writer.setAttribute( 'language', value, range );
-					} else {
-						writer.removeAttribute( 'language', range );
-					}
-				}
-			}
-		} );
-	}
-
-	/**
-	 * Returns the attribute value of the first node in the selection that allows the attribute.
-	 * For a collapsed selection it returns the selection attribute.
-	 *
-	 * @private
-	 * @returns {Boolean|String} The attribute value.
-	 */
-	_getValueFromFirstAllowedNode() {
-		const model = this.editor.model;
-		const schema = model.schema;
-		const selection = model.document.selection;
-
-		if ( selection.isCollapsed ) {
-			return selection.getAttribute( 'language' ) || false;
-		}
-
-		for ( const range of selection.getRanges() ) {
-			for ( const item of range.getItems() ) {
-				if ( schema.checkAttribute( item, 'language' ) ) {
-					return item.getAttribute( 'language' ) || false;
-				}
-			}
-		}
-
-		return false;
-	}
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const model = this.editor.model;
+        const doc = model.document;
+        this.value = this._getValueFromFirstAllowedNode();
+        this.isEnabled = model.schema.checkAttributeInSelection(doc.selection, 'language');
+    }
+    /**
+     * Executes the command. Applies the attribute to the selection or removes it from the selection.
+     *
+     * If `languageCode` is set to `false` or a `null` value, it will remove attributes. Otherwise, it will set
+     * the attribute in the `{@link #value value}` format.
+     *
+     * The execution result differs, depending on the {@link module:engine/model/document~Document#selection}:
+     *
+     * * If the selection is on a range, the command applies the attribute to all nodes in that range
+     * (if they are allowed to have this attribute by the {@link module:engine/model/schema~Schema schema}).
+     * * If the selection is collapsed in a non-empty node, the command applies the attribute to the
+     * {@link module:engine/model/document~Document#selection} itself (note that typed characters copy attributes from the selection).
+     * * If the selection is collapsed in an empty node, the command applies the attribute to the parent node of the selection (note
+     * that the selection inherits all attributes from a node if it is in an empty node).
+     *
+     * @fires execute
+     * @param options Command options.
+     * @param options.languageCode The language code to be applied to the model.
+     * @param options.textDirection The language text direction.
+     */
+    execute({ languageCode, textDirection } = {}) {
+        const model = this.editor.model;
+        const doc = model.document;
+        const selection = doc.selection;
+        const value = languageCode ? stringifyLanguageAttribute(languageCode, textDirection) : false;
+        model.change(writer => {
+            if (selection.isCollapsed) {
+                if (value) {
+                    writer.setSelectionAttribute('language', value);
+                }
+                else {
+                    writer.removeSelectionAttribute('language');
+                }
+            }
+            else {
+                const ranges = model.schema.getValidRanges(selection.getRanges(), 'language');
+                for (const range of ranges) {
+                    if (value) {
+                        writer.setAttribute('language', value, range);
+                    }
+                    else {
+                        writer.removeAttribute('language', range);
+                    }
+                }
+            }
+        });
+    }
+    /**
+     * Returns the attribute value of the first node in the selection that allows the attribute.
+     * For a collapsed selection it returns the selection attribute.
+     *
+     * @returns The attribute value.
+     */
+    _getValueFromFirstAllowedNode() {
+        const model = this.editor.model;
+        const schema = model.schema;
+        const selection = model.document.selection;
+        if (selection.isCollapsed) {
+            return selection.getAttribute('language') || false;
+        }
+        for (const range of selection.getRanges()) {
+            for (const item of range.getItems()) {
+                if (schema.checkAttribute(item, 'language')) {
+                    return item.getAttribute('language') || false;
+                }
+            }
+        }
+        return false;
+    }
 }

package/src/textpartlanguageediting.js

@@ -1,105 +1,84 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
-/**
- * @module language/textpartlanguageediting
- */
-
 import { Plugin } from 'ckeditor5/src/core';
 import TextPartLanguageCommand from './textpartlanguagecommand';
 import { stringifyLanguageAttribute, parseLanguageAttribute } from './utils';
-
 /**
  * The text part language editing.
  *
  * Introduces the `'textPartLanguage'` command and the `'language'` model element attribute.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class TextPartLanguageEditing extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'TextPartLanguageEditing';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	constructor( editor ) {
-		super( editor );
-
-		// Text part language options are only used to ensure that the feature works by default.
-		// In the real usage it should be reconfigured by a developer. We are not providing
-		// translations for `title` properties on purpose, as it's only an example configuration.
-		editor.config.define( 'language', {
-			textPartLanguage: [
-				{ title: 'Arabic', languageCode: 'ar' },
-				{ title: 'French', languageCode: 'fr' },
-				{ title: 'Spanish', languageCode: 'es' }
-			]
-		} );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-
-		editor.model.schema.extend( '$text', { allowAttributes: 'language' } );
-		editor.model.schema.setAttributeProperties( 'language', {
-			copyOnEnter: true
-		} );
-
-		this._defineConverters();
-
-		editor.commands.add( 'textPartLanguage', new TextPartLanguageCommand( editor ) );
-	}
-
-	/**
-	 * @private
-	 */
-	_defineConverters() {
-		const conversion = this.editor.conversion;
-
-		conversion.for( 'upcast' ).elementToAttribute( {
-			model: {
-				key: 'language',
-				value: viewElement => {
-					const languageCode = viewElement.getAttribute( 'lang' );
-					const textDirection = viewElement.getAttribute( 'dir' );
-
-					return stringifyLanguageAttribute( languageCode, textDirection );
-				}
-			},
-			view: {
-				name: 'span',
-				attributes: { lang: /[\s\S]+/ }
-			}
-		} );
-
-		conversion.for( 'downcast' ).attributeToElement( {
-			model: 'language',
-			view: ( attributeValue, { writer }, data ) => {
-				if ( !attributeValue ) {
-					return;
-				}
-
-				if ( !data.item.is( '$textProxy' ) && !data.item.is( 'documentSelection' ) ) {
-					return;
-				}
-
-				const { languageCode, textDirection } = parseLanguageAttribute( attributeValue );
-
-				return writer.createAttributeElement( 'span', {
-					lang: languageCode,
-					dir: textDirection
-				} );
-			}
-		} );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TextPartLanguageEditing';
+    }
+    /**
+     * @inheritDoc
+     */
+    constructor(editor) {
+        super(editor);
+        // Text part language options are only used to ensure that the feature works by default.
+        // In the real usage it should be reconfigured by a developer. We are not providing
+        // translations for `title` properties on purpose, as it's only an example configuration.
+        editor.config.define('language', {
+            textPartLanguage: [
+                { title: 'Arabic', languageCode: 'ar' },
+                { title: 'French', languageCode: 'fr' },
+                { title: 'Spanish', languageCode: 'es' }
+            ]
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        editor.model.schema.extend('$text', { allowAttributes: 'language' });
+        editor.model.schema.setAttributeProperties('language', {
+            copyOnEnter: true
+        });
+        this._defineConverters();
+        editor.commands.add('textPartLanguage', new TextPartLanguageCommand(editor));
+    }
+    /**
+     * @private
+     */
+    _defineConverters() {
+        const conversion = this.editor.conversion;
+        conversion.for('upcast').elementToAttribute({
+            model: {
+                key: 'language',
+                value: (viewElement) => {
+                    const languageCode = viewElement.getAttribute('lang');
+                    const textDirection = viewElement.getAttribute('dir');
+                    return stringifyLanguageAttribute(languageCode, textDirection);
+                }
+            },
+            view: {
+                name: 'span',
+                attributes: { lang: /[\s\S]+/ }
+            }
+        });
+        conversion.for('downcast').attributeToElement({
+            model: 'language',
+            view: (attributeValue, { writer }, data) => {
+                if (!attributeValue) {
+                    return;
+                }
+                if (!data.item.is('$textProxy') && !data.item.is('documentSelection')) {
+                    return;
+                }
+                const { languageCode, textDirection } = parseLanguageAttribute(attributeValue);
+                return writer.createAttributeElement('span', {
+                    lang: languageCode,
+                    dir: textDirection
+                });
+            }
+        });
+    }
 }

package/src/textpartlanguageui.js

@@ -1,119 +1,96 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module language/textpartlanguageui
  */
-
 import { Plugin } from 'ckeditor5/src/core';
 import { Model, createDropdown, addListToDropdown } from 'ckeditor5/src/ui';
 import { Collection } from 'ckeditor5/src/utils';
 import { stringifyLanguageAttribute } from './utils';
-
 import '../theme/language.css';
-
 /**
  * The text part language UI plugin.
  *
  * It introduces the `'language'` dropdown.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class TextPartLanguageUI extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'TextPartLanguageUI';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	init() {
-		const editor = this.editor;
-		const t = editor.t;
-		const options = editor.config.get( 'language.textPartLanguage' );
-		const defaultTitle = t( 'Choose language' );
-		const removeTitle = t( 'Remove language' );
-		const dropdownTooltip = t( 'Language' );
-
-		// Register UI component.
-		editor.ui.componentFactory.add( 'textPartLanguage', locale => {
-			const itemDefinitions = new Collection();
-			const titles = {};
-
-			const languageCommand = editor.commands.get( 'textPartLanguage' );
-
-			// Item definition with false `languageCode` will behave as remove lang button.
-			itemDefinitions.add( {
-				type: 'button',
-				model: new Model( {
-					label: removeTitle,
-					languageCode: false,
-					withText: true
-				} )
-			} );
-
-			itemDefinitions.add( {
-				type: 'separator'
-			} );
-
-			for ( const option of options ) {
-				const def = {
-					type: 'button',
-					model: new Model( {
-						label: option.title,
-						languageCode: option.languageCode,
-						textDirection: option.textDirection,
-						withText: true
-					} )
-				};
-
-				const language = stringifyLanguageAttribute( option.languageCode, option.textDirection );
-
-				def.model.bind( 'isOn' ).to( languageCommand, 'value', value => value === language );
-
-				itemDefinitions.add( def );
-
-				titles[ language ] = option.title;
-			}
-
-			const dropdownView = createDropdown( locale );
-			addListToDropdown( dropdownView, itemDefinitions );
-
-			dropdownView.buttonView.set( {
-				isOn: false,
-				withText: true,
-				tooltip: dropdownTooltip
-			} );
-
-			dropdownView.extendTemplate( {
-				attributes: {
-					class: [
-						'ck-text-fragment-language-dropdown'
-					]
-				}
-			} );
-
-			dropdownView.bind( 'isEnabled' ).to( languageCommand, 'isEnabled' );
-			dropdownView.buttonView.bind( 'label' ).to( languageCommand, 'value', value => {
-				return titles[ value ] || defaultTitle;
-			} );
-
-			// Execute command when an item from the dropdown is selected.
-			this.listenTo( dropdownView, 'execute', evt => {
-				languageCommand.execute( {
-					languageCode: evt.source.languageCode,
-					textDirection: evt.source.textDirection
-				} );
-
-				editor.editing.view.focus();
-			} );
-
-			return dropdownView;
-		} );
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TextPartLanguageUI';
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        const t = editor.t;
+        const options = editor.config.get('language.textPartLanguage');
+        const defaultTitle = t('Choose language');
+        const removeTitle = t('Remove language');
+        const dropdownTooltip = t('Language');
+        // Register UI component.
+        editor.ui.componentFactory.add('textPartLanguage', locale => {
+            const itemDefinitions = new Collection();
+            const titles = {};
+            const languageCommand = editor.commands.get('textPartLanguage');
+            // Item definition with false `languageCode` will behave as remove lang button.
+            itemDefinitions.add({
+                type: 'button',
+                model: new Model({
+                    label: removeTitle,
+                    languageCode: false,
+                    withText: true
+                })
+            });
+            itemDefinitions.add({
+                type: 'separator'
+            });
+            for (const option of options) {
+                const def = {
+                    type: 'button',
+                    model: new Model({
+                        label: option.title,
+                        languageCode: option.languageCode,
+                        textDirection: option.textDirection,
+                        withText: true
+                    })
+                };
+                const language = stringifyLanguageAttribute(option.languageCode, option.textDirection);
+                def.model.bind('isOn').to(languageCommand, 'value', value => value === language);
+                itemDefinitions.add(def);
+                titles[language] = option.title;
+            }
+            const dropdownView = createDropdown(locale);
+            addListToDropdown(dropdownView, itemDefinitions);
+            dropdownView.buttonView.set({
+                isOn: false,
+                withText: true,
+                tooltip: dropdownTooltip
+            });
+            dropdownView.extendTemplate({
+                attributes: {
+                    class: [
+                        'ck-text-fragment-language-dropdown'
+                    ]
+                }
+            });
+            dropdownView.bind('isEnabled').to(languageCommand, 'isEnabled');
+            dropdownView.buttonView.bind('label').to(languageCommand, 'value', value => {
+                return (value && titles[value]) || defaultTitle;
+            });
+            // Execute command when an item from the dropdown is selected.
+            this.listenTo(dropdownView, 'execute', evt => {
+                languageCommand.execute({
+                    languageCode: evt.source.languageCode,
+                    textDirection: evt.source.textDirection
+                });
+                editor.editing.view.focus();
+            });
+            return dropdownView;
+        });
+    }
 }

package/src/utils.js

@@ -1,18 +1,17 @@
 /**
- * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module language/utils
  */
-
 import { getLanguageDirection } from 'ckeditor5/src/utils';
-
 /**
  * Returns the language attribute value in a human-readable text format:
  *
- *		<languageCode>:<textDirection>
+ * ```
+ * <languageCode>:<textDirection>
+ * ```
  *
  * * `languageCode` - The language code used for the `lang` attribute in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
  * * `textDirection` - One of the following values: `rtl` or `ltr`, indicating the reading direction of the language.
@@ -22,26 +21,23 @@ import { getLanguageDirection } from 'ckeditor5/src/utils';
  *
  * If the `textDirection` argument is omitted, it will be automatically detected based on `languageCode`.
  *
- * @param {String} languageCode The language code in the ISO 639-1 format.
- * @param {'ltr'|'rtl'} [textDirection] The language text direction. Automatically detected if omitted.
- * @returns {String}
+ * @param languageCode The language code in the ISO 639-1 format.
+ * @param textDirection The language text direction. Automatically detected if omitted.
  */
-export function stringifyLanguageAttribute( languageCode, textDirection ) {
-	textDirection = textDirection || getLanguageDirection( languageCode );
-	return `${ languageCode }:${ textDirection }`;
+export function stringifyLanguageAttribute(languageCode, textDirection) {
+    textDirection = textDirection || getLanguageDirection(languageCode);
+    return `${languageCode}:${textDirection}`;
 }
-
 /**
  * Retrieves language properties converted to attribute value by the
  * {@link module:language/utils~stringifyLanguageAttribute stringifyLanguageAttribute} function.
  *
- * @param {String} str The attribute value.
- * @returns {Object} result
- * @returns {String} result.languageCode The language code in the ISO 639 format.
- * @returns {String} result.textDirection The language text direction.
+ * @param str The attribute value.
+ * @returns The object with properties:
+ * * languageCode - The language code in the ISO 639 format.
+ * * textDirection - The language text direction.
  */
-export function parseLanguageAttribute( str ) {
-	const [ languageCode, textDirection ] = str.split( ':' );
-
-	return { languageCode, textDirection };
+export function parseLanguageAttribute(str) {
+    const [languageCode, textDirection] = str.split(':');
+    return { languageCode, textDirection };
 }

package/theme/language.css

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */