diff options
author | toasted-nutbread <toasted-nutbread@users.noreply.github.com> | 2023-11-27 12:48:14 -0500 |
---|---|---|
committer | toasted-nutbread <toasted-nutbread@users.noreply.github.com> | 2023-11-27 12:48:14 -0500 |
commit | 4da4827bcbcdd1ef163f635d9b29416ff272b0bb (patch) | |
tree | a8a0f1a8befdb78a554e1be91f2c6059ca3ad5f9 /docs/interfaces/dictionary-entry.ts | |
parent | fd6bba8a2a869eaf2b2c1fa49001f933fce3c618 (diff) |
Add JSDoc type annotations to project (rebased)
Diffstat (limited to 'docs/interfaces/dictionary-entry.ts')
-rw-r--r-- | docs/interfaces/dictionary-entry.ts | 479 |
1 files changed, 0 insertions, 479 deletions
diff --git a/docs/interfaces/dictionary-entry.ts b/docs/interfaces/dictionary-entry.ts deleted file mode 100644 index 2ad8f70f..00000000 --- a/docs/interfaces/dictionary-entry.ts +++ /dev/null @@ -1,479 +0,0 @@ -/* - * Copyright (C) 2023 Yomitan Authors - * Copyright (C) 2021-2022 Yomichan Authors - * - * This program is free software: you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program. If not, see <https://www.gnu.org/licenses/>. - */ - -namespace Translation { - // Common - - /** - * Enum representing the type of a `DictionaryEntry`. - * `'kanji'` corresponds to a KanjiDictionaryEntry. - * `'term'` corresponds to a TermDictionaryEntry. - */ - export enum DictionaryEntryType { - Kanji = 'kanji', - Term = 'term', - } - - /** - * A generic dictionary entry which is used as the base interface. - */ - export interface DictionaryEntry { - /** - * The type of the entry. - */ - type: DictionaryEntryType; - } - - /** - * A tag represents some brief information about part of a dictionary entry. - */ - export interface Tag { - /** - * The name of the tag. - */ - name: string; - /** - * The category of the tag. - */ - category: string; - /** - * A number indicating the sorting order of the tag. - */ - order: number; - /** - * A score value for the tag. - */ - score: number; - /** - * An array of descriptions for the tag. * If there are multiple entries, - * the values will typically have originated from different dictionaries. - * However, there is no correlation between the length of this array and - * the length of the `dictionaries` field, as duplicates are removed. - */ - content: string[]; - /** - * An array of dictionary names that contained a tag with this name and category. - */ - dictionaries: string[]; - /** - * Whether or not this tag is redundant with previous tags. - */ - redundant: boolean; - } - - // Kanji - - /** - * A dictionary entry for a kanji character. - * `DictionaryEntry.type` is always `DictionaryEntryType.Kanji`. - */ - export interface KanjiDictionaryEntry extends DictionaryEntry { - /** - * The kanji character that was looked up. - */ - character: string; - /** - * The name of the dictionary that the information originated from. - */ - dictionary: string; - /** - * Onyomi readings for the kanji character. - */ - onyomi: string[]; - /** - * Kunyomi readings for the kanji character. - */ - kunyomi: string[]; - /** - * Tags for the kanji character. - */ - tags: Tag[]; - /** - * An object containing stats about the kanji character. - */ - stats: KanjiStatGroups; - /** - * Definitions for the kanji character. - */ - definitions: string[]; - /** - * Frequency information for the kanji character. - */ - frequencies: KanjiFrequency[]; - } - - /** - * An object with groups of stats about a kanji character. - */ - export interface KanjiStatGroups { - /** - * A group of stats. - * @param propName The name of the group. - */ - [propName: string]: KanjiStat[]; - } - - /** - * A stat represents a generic piece of information about a kanji character. - */ - export interface KanjiStat { - /** - * The name of the stat. - */ - name: string; - /** - * The category of the stat. - */ - category: string; - /** - * A description of the stat. - */ - content: string; - /** - * A number indicating the sorting order of the stat. - */ - order: number; - /** - * A score value for the stat. - */ - score: number; - /** - * The name of the dictionary that the stat originated from. - */ - dictionary: string; - /** - * A value for the stat. - */ - value: number | string; - } - - /** - * Frequency information corresponds to how frequently a character appears in a corpus, - * which can be a number of occurrences or an overall rank. - */ - export interface KanjiFrequency { - /** - * The original order of the frequency, which is usually used for sorting. - */ - index: number; - /** - * The name of the dictionary that the frequency information originated from. - */ - dictionary: string; - /** - * The index of the dictionary in the original list of dictionaries used for the lookup. - */ - dictionaryIndex: number; - /** - * The priority of the dictionary. - */ - dictionaryPriority: number; - /** - * The kanji character for the frequency. - */ - character: string; - /** - * The frequency for the character, as a number of occurrences or an overall rank. - */ - frequency: number; - /** - * A display value to show to the user. - */ - displayValue: string | null; - /** - * Whether or not the displayValue string was parsed to determine the frequency value. - */ - displayValueParsed: boolean; - } - - // Terms - - /** - * A dictionary entry for a term or group of terms. - * `DictionaryEntry.type` is always `DictionaryEntryType.Term`. - */ - export interface TermDictionaryEntry extends DictionaryEntry { - /** - * Whether or not any of the sources is a primary source. Primary sources are derived from the - * original search text, while non-primary sources originate from related terms. - */ - isPrimary: boolean; - /** - * A list of inflections that was applied to get the term. - */ - inflections: string[]; - /** - * A score for the dictionary entry. - */ - score: number; - /** - * The index of the dictionary in the original list of dictionaries used for the lookup. - */ - dictionaryIndex: number; - /** - * The priority of the dictionary. - */ - dictionaryPriority: number; - /** - * The number of primary sources that had an exact text match for the term. - */ - sourceTermExactMatchCount: number; - /** - * The maximum length of the transformed text for all primary sources. - */ - maxTransformedTextLength: number; - /** - * Headwords for the entry. - */ - headwords: TermHeadword[]; - /** - * Definitions for the entry. - */ - definitions: TermDefinition[]; - /** - * Pronunciations for the entry. - */ - pronunciations: TermPronunciation[]; - /** - * Frequencies for the entry. - */ - frequencies: TermFrequency[]; - } - - /** - * A term headword is a combination of a term, reading, and auxiliary information. - */ - export interface TermHeadword { - /** - * The original order of the headword, which is usually used for sorting. - */ - index: number; - /** - * The text for the term. - */ - term: string; - /** - * The reading of the term. - */ - reading: string; - /** - * The sources of the term. - */ - sources: TermSource[]; - /** - * Tags for the headword. - */ - tags: Tag[]; - /** - * List of word classes (part of speech) for the headword. - */ - wordClasses: string[]; - } - - /** - * A definition contains a list of entries and information about what what terms it corresponds to. - */ - export interface TermDefinition { - /** - * The original order of the definition, which is usually used for sorting. - */ - index: number; - /** - * A list of headwords that this definition corresponds to. - */ - headwordIndices: number[]; - /** - * The name of the dictionary that the definition information originated from. - */ - dictionary: string; - /** - * The index of the dictionary in the original list of dictionaries used for the lookup. - */ - dictionaryIndex: number; - /** - * The priority of the dictionary. - */ - dictionaryPriority: number; - /** - * Database ID for the definition. - */ - id: number[]; - /** - * A score for the definition. - */ - score: number; - /** - * A list of database sequence numbers for the term. A value of `-1` corresponds to no sequence. - * The list can have multiple values if multiple definitions with different sequences have been merged. - * The list should always have at least one item. - */ - sequences: number; - /** - * Tags for the definition. - */ - tags: Tag[]; - /** - * The definition entries. - */ - entries: string[]; - } - - /** - * A term pronunciation represents different ways to pronounce one of the headwords. - */ - export interface TermPronunciation { - /** - * The original order of the pronunciation, which is usually used for sorting. - */ - index: number; - /** - * Which headword this pronunciation corresponds to. - */ - headwordIndex: number; - /** - * The name of the dictionary that the proununciation information originated from. - */ - dictionary: string; - /** - * The index of the dictionary in the original list of dictionaries used for the lookup. - */ - dictionaryIndex: number; - /** - * The priority of the dictionary. - */ - dictionaryPriority: number; - /** - * The pitch accent representations for the term. - */ - pitches: TermPitch[]; - } - - /** - * Pitch accent information for a term, represented as the position of the downstep. - */ - export interface TermPitch { - /** - * Position of the downstep, as a number of mora. - */ - position: number; - /** - * Positions of morae with a nasal sound. - */ - nasalPositions: number[]; - /** - * Positions of morae with a devoiced sound. - */ - devoicePositions: []; - /** - * Tags for the pitch accent. - */ - tags: Tag[]; - } - - /** - * Frequency information corresponds to how frequently a term appears in a corpus, - * which can be a number of occurrences or an overall rank. - */ - export interface TermFrequency { - /** - * The original order of the frequency, which is usually used for sorting. - */ - index: number; - /** - * Which headword this frequency corresponds to. - */ - headwordIndex: number; - /** - * The name of the dictionary that the frequency information originated from. - */ - dictionary: string; - /** - * The index of the dictionary in the original list of dictionaries used for the lookup. - */ - dictionaryIndex: number; - /** - * The priority of the dictionary. - */ - dictionaryPriority: number; - /** - * Whether or not the frequency had an explicit reading specified. - */ - hasReading: boolean; - /** - * The frequency for the term, as a number of occurrences or an overall rank. - */ - frequency: number; - /** - * A display value to show to the user. - */ - displayValue: string | null; - /** - * Whether or not the displayValue string was parsed to determine the frequency value. - */ - displayValueParsed: boolean; - } - - /** - * Enum representing how the search term relates to the final term. - */ - export enum TermSourceMatchType { - Exact = 'exact', - Prefix = 'prefix', - Suffix = 'suffix', - } - - /** - * Enum representing what database field was used to match the source term. - */ - export enum TermSourceMatchSource { - Term = 'term', - Reading = 'reading', - Sequence = 'sequence', - } - - /** - * Source information represents how the original text was transformed to get to the final term. - */ - export interface TermSource { - /** - * The original text that was searched. - */ - originalText: string; - /** - * The original text after being transformed, but before applying deinflections. - */ - transformedText: string; - /** - * The final text after applying deinflections. - */ - deinflectedText: string; - /** - * How the deinflected text matches the value from the database. - */ - matchType: TermSourceMatchType; - /** - * Which field was used to match the database entry. - */ - matchSource: TermSourceMatchSource; - /** - * Whether or not this source is a primary source. Primary sources are derived from the - * original search text, while non-primary sources originate from related terms. - */ - isPrimary: boolean; - } -} |