From 5f96276fda93dcad39f2165fd3c8d890aa5f9be5 Mon Sep 17 00:00:00 2001 From: Cashew <52880648+Scrub1492@users.noreply.github.com> Date: Tue, 19 Dec 2023 14:22:22 +0900 Subject: update JSDoc comments (#387) * lesen-tan initial commit * update README.md * tidy up code * opt for Map instead of Object * Document dev/* * add docs for deinflector.js * update deinflector example * Annotate * Revert "Merge branch 'development' of https://github.com/Scrub1492/lesen-tan into development" This reverts commit b92348f702bc031b36f24462adfa940d17f9ecdd, reversing changes made to 3255e6d963281af3533dcf1e893df39032d29fec. * Lint error fix * Lint error fix * update JSDoc comments --------- Co-authored-by: Darius Jahandarie --- ext/js/data/anki-note-builder.js | 28 ---------------------------- ext/js/data/database.js | 11 ++++------- ext/js/language/deinflector.js | 6 +----- ext/js/language/dictionary-database.js | 28 +++++++--------------------- 4 files changed, 12 insertions(+), 61 deletions(-) (limited to 'ext') diff --git a/ext/js/data/anki-note-builder.js b/ext/js/data/anki-note-builder.js index 80cc210a..9240c1d8 100644 --- a/ext/js/data/anki-note-builder.js +++ b/ext/js/data/anki-note-builder.js @@ -22,16 +22,10 @@ import {TemplateRendererProxy} from '../templates/template-renderer-proxy.js'; import {yomitan} from '../yomitan.js'; import {AnkiUtil} from './anki-util.js'; -/** - * Anki Note Builder Class. - */ export class AnkiNoteBuilder { /** * Initiate an instance of AnkiNoteBuilder. * @param {{japaneseUtil: import('../language/sandbox/japanese-util.js').JapaneseUtil}} details - * @example - * const japaneseUtil = new JapaneseUtil(null); - * const ankiNoteBuilder = new AnkiNoteBuilder({japaneseUtil}); */ constructor({japaneseUtil}) { /** @type {import('../language/sandbox/japanese-util.js').JapaneseUtil} */ @@ -47,30 +41,8 @@ export class AnkiNoteBuilder { } /** - * Creates an Anki note. * @param {import('anki-note-builder').CreateNoteDetails} details * @returns {Promise} - * @example - * const ankiNoteBuilder = new AnkiNoteBuilder({japaneseUtil}); - * const details = { - * dictionaryEntry, - * mode: 'test', - * context, - * template, - * deckName: 'deckName', - * modelName: 'modelName', - * fields, - * tags: ['yomitan'], - * checkForDuplicates: true, - * duplicateScope: 'collection', - * duplicateScopeCheckAllModels: false, - * resultOutputMode: mode, - * glossaryLayoutMode: 'default', - * compactTags: false, - * requirements: [], - * mediaOptions: null - * }; - * const {note: {fields: noteFields}, errors} = await ankiNoteBuilder.createNote(details); */ async createNote({ dictionaryEntry, diff --git a/ext/js/data/database.js b/ext/js/data/database.js index 5aba1373..c8047b41 100644 --- a/ext/js/data/database.js +++ b/ext/js/data/database.js @@ -17,7 +17,6 @@ */ /** - * Database class to store objects. * @template {string} TObjectStoreName */ export class Database { @@ -29,7 +28,6 @@ export class Database { } /** - * Opens the DB. * @param {string} databaseName * @param {number} version * @param {import('database').StructureDefinition[]} structure @@ -53,7 +51,6 @@ export class Database { } /** - * Closes the DB. * @throws {Error} */ close() { @@ -66,7 +63,7 @@ export class Database { } /** - * Returns true if DB opening is in process. + * Returns true if the database opening is in process. * @returns {boolean} */ isOpening() { @@ -74,7 +71,7 @@ export class Database { } /** - * Returns true if the DB is open. + * Returns true if the database is fully opened. * @returns {boolean} */ isOpen() { @@ -97,10 +94,10 @@ export class Database { /** * Add items in bulk to the object store. - * count items will be added beginning from start index of items list. + * _count_ items will be added, starting from _start_ index of _items_ list. * @param {TObjectStoreName} objectStoreName * @param {unknown[]} items List of items to add. - * @param {number} start Start index. Added items begin at items[start]. + * @param {number} start Start index. Added items begin at _items_[_start_]. * @param {number} count Count of items to add. * @returns {Promise} */ diff --git a/ext/js/language/deinflector.js b/ext/js/language/deinflector.js index 90ca79ea..676f45a1 100644 --- a/ext/js/language/deinflector.js +++ b/ext/js/language/deinflector.js @@ -16,16 +16,13 @@ * along with this program. If not, see . */ -/** - * This class deinflects Japanese terms to its dictionary form. - */ export class Deinflector { /** * @param {import('deinflector').ReasonsRaw} reasons * @example * const deinflectionReasons = JSON.parse( * readFileSync(path.join('ext/data/deinflect.json')).toString(), - * ) as object; + * ); * const deinflector = new Deinflector(deinflectionReasons); */ constructor(reasons) { @@ -101,7 +98,6 @@ export class Deinflector { } /** - * Given a list of rules, return the corresponding deinflection rule flags. * @param {string[]} rules * @returns {import('translation-internal').DeinflectionRuleFlags} */ diff --git a/ext/js/language/dictionary-database.js b/ext/js/language/dictionary-database.js index ce5041c8..c47e1e90 100644 --- a/ext/js/language/dictionary-database.js +++ b/ext/js/language/dictionary-database.js @@ -19,9 +19,6 @@ import {log, stringReverse} from '../core.js'; import {Database} from '../data/database.js'; -/** - * This class represents the dictionary database. - */ export class DictionaryDatabase { constructor() { /** @type {Database} */ @@ -144,7 +141,6 @@ export class DictionaryDatabase { } /** - * Purges the database. * @returns {Promise} */ async purge() { @@ -166,7 +162,6 @@ export class DictionaryDatabase { } /** - * Deletes a dictionary. * @param {string} dictionaryName * @param {number} progressRate * @param {import('dictionary-database').DeleteDictionaryProgressCallback} onProgress @@ -230,10 +225,9 @@ export class DictionaryDatabase { } /** - * Find terms in bulk. - * @param {string[]} termList The list of terms to find. - * @param {import('dictionary-database').DictionarySet} dictionaries Dictionaries to find the terms from. - * @param {import('dictionary-database').MatchType} matchType Matching type. + * @param {string[]} termList + * @param {import('dictionary-database').DictionarySet} dictionaries + * @param {import('dictionary-database').MatchType} matchType * @returns {Promise} */ findTermsBulk(termList, dictionaries, matchType) { @@ -265,9 +259,8 @@ export class DictionaryDatabase { } /** - * Find exact terms in bulk. - * @param {import('dictionary-database').TermExactRequest[]} termList The list of terms to find. - * @param {import('dictionary-database').DictionarySet} dictionaries Dictionaries to find the term from. + * @param {import('dictionary-database').TermExactRequest[]} termList + * @param {import('dictionary-database').DictionarySet} dictionaries * @returns {Promise} */ findTermsExactBulk(termList, dictionaries) { @@ -277,7 +270,6 @@ export class DictionaryDatabase { } /** - * Find terms by sequence in bulk. * @param {import('dictionary-database').DictionaryAndQueryRequest[]} items * @returns {Promise} */ @@ -288,7 +280,6 @@ export class DictionaryDatabase { } /** - * Find term meta in bulk. * @param {string[]} termList * @param {import('dictionary-database').DictionarySet} dictionaries * @returns {Promise} @@ -300,9 +291,8 @@ export class DictionaryDatabase { } /** - * Find kanji in bulk. - * @param {string[]} kanjiList The list of kanji to find. - * @param {import('dictionary-database').DictionarySet} dictionaries Dictionaries to find from. + * @param {string[]} kanjiList + * @param {import('dictionary-database').DictionarySet} dictionaries * @returns {Promise} */ findKanjiBulk(kanjiList, dictionaries) { @@ -312,7 +302,6 @@ export class DictionaryDatabase { } /** - * Find kanji meta in bulk. * @param {string[]} kanjiList * @param {import('dictionary-database').DictionarySet} dictionaries * @returns {Promise} @@ -324,7 +313,6 @@ export class DictionaryDatabase { } /** - * Find tag meta in bulk. * @param {import('dictionary-database').DictionaryAndQueryRequest[]} items * @returns {Promise<(import('dictionary-database').Tag|undefined)[]>} */ @@ -335,7 +323,6 @@ export class DictionaryDatabase { } /** - * Find tag for title. * @param {string} name * @param {string} dictionary * @returns {Promise} @@ -356,7 +343,6 @@ export class DictionaryDatabase { } /** - * Get dictionary metadata. * @returns {Promise} */ getDictionaryInfo() { -- cgit v1.2.3