feat: add JSDoc generation, fix JSDoc annotations

- Add jsdoc.config.json and `npm run docs` script
- Add docs CI job (generates JSDoc, uploads as artifact)
- Remove redundant bare `@exports` tags (16 files)
- Fix invalid type expressions: `{?...X}` → `{...X}`,
  `{Array[Function]}` → `{Array.<Function>}`
- Add docs/, test-results/ to .gitignore
- Exclude docs/ from ESLint

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: veged

.github/workflows/ci.yml

@@ -58,3 +58,18 @@ jobs:
         with:
           name: dist
           path: dist/
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run docs
+      - uses: actions/upload-artifact@v4
+        with:
+          name: jsdoc
+          path: docs/jsdoc/

.gitignore

@@ -17,6 +17,8 @@ coverage.json
 !*.bundles/*/*.bemjson.js
 
 /dist
+/docs/jsdoc
+/test-results
 /*desktop.docs
 /*touch.docs
 /*.examples

common.blocks/cookie/cookie.js

@@ -3,7 +3,7 @@
  * @description Inspired from $.cookie plugin by Klaus Hartl (stilbuero.de)
  */
 
-export default /** @exports */{
+export default {
     /**
      * Returns cookie by given name
      * @param {String} name

common.blocks/dom/dom.js

@@ -19,7 +19,7 @@ var EDITABLE_INPUT_TYPES = {
     week : true
 };
 
-export default /** @exports */{
+export default {
     /**
      * Checks whether a DOM elem is in a context
      * @param {jQuery} ctx DOM elem where check is being performed

common.blocks/events/__channels/events__channels.vanilla.js

@@ -10,7 +10,6 @@ var undef,
 export default
     /**
      * Returns/destroys a named communication channel
-     * @exports
      * @param {String} [id='default'] Channel ID
      * @param {Boolean} [drop=false] Destroy the channel
      * @returns {events:Emitter|undefined} Communication channel

common.blocks/events/__observable/_type/events__observable_type_bem-dom.js

@@ -8,7 +8,6 @@ import observable from 'bem:events__observable';
 export default
     /**
      * Creates new observable with BEM DOM entity support
-     * @exports
      * @param {i-bem-dom:Block|i-bem-dom:Elem|events:Emitter} bemEntity
      * @returns {Observable}
      */

common.blocks/events/__observable/events__observable.js

@@ -58,7 +58,6 @@ var Observable = inherit(/** @lends Observable.prototype */{
 export default
     /**
      * Creates new observable
-     * @exports
      * @param {events:Emitter} emitter
      * @returns {Observable}
      */

common.blocks/functions/__debounce/functions__debounce.vanilla.js

@@ -5,7 +5,6 @@
 export default
     /**
      * Debounces given function
-     * @exports
      * @param {Function} fn function to debounce
      * @param {Number} timeout debounce interval
      * @param {Boolean} [invokeAsap=false] invoke before first interval

common.blocks/functions/__throttle/functions__throttle.vanilla.js

@@ -5,7 +5,6 @@
 export default
     /**
      * Throttle given function
-     * @exports
      * @param {Function} fn function to throttle
      * @param {Number} timeout throttle interval
      * @param {Boolean} [invokeAsap=true] invoke before first interval

common.blocks/functions/functions.vanilla.js

@@ -3,7 +3,7 @@
  * @description A set of helpers to work with JavaScript functions
  */
 
-export default /** @exports */{
+export default {
     /**
      * Checks whether a given object is function
      * @param {*} obj