summaryrefslogtreecommitdiff
path: root/docs/interfaces
diff options
context:
space:
mode:
Diffstat (limited to 'docs/interfaces')
-rw-r--r--docs/interfaces/dictionary-entry.ts479
-rw-r--r--docs/interfaces/translator-types.ts178
2 files changed, 0 insertions, 657 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;
- }
-}
diff --git a/docs/interfaces/translator-types.ts b/docs/interfaces/translator-types.ts
deleted file mode 100644
index 305f5ef2..00000000
--- a/docs/interfaces/translator-types.ts
+++ /dev/null
@@ -1,178 +0,0 @@
-/*
- * Copyright (C) 2023 Yomitan Authors
- * Copyright (C) 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 {
- // Kanji
-
- /**
- * An options object for use with `Translator.findKanji`.
- */
- export interface FindKanjiOptions {
- /**
- * The mapping of dictionaries to search for kanji in.
- * The key is the dictionary name.
- */
- enabledDictionaryMap: Map<string, FindKanjiDictionary>;
- }
-
- /**
- * Details about a dictionary.
- */
- export interface FindKanjiDictionary {
- /**
- * The index of the dictionary
- */
- index: number;
- /**
- * The priority of the dictionary
- */
- priority: number;
- }
-
- // Terms
-
- /**
- * An options object for use with `Translator.findTerms`.
- */
- export interface FindTermsOptions {
- /**
- * The matching type for looking up terms.
- */
- matchType: FindTermsMatchType;
- /**
- * The name of the primary dictionary to search.
- */
- mainDictionary: string;
- /**
- * The name of the frequency dictionary used for sorting
- */
- sortFrequencyDictionary: string | null;
- /**
- * The order used when using a sorting dictionary.
- */
- sortFrequencyDictionaryOrder: FindTermsSortOrder;
- /**
- * Whether or not non-Japanese characters should be searched.
- */
- removeNonJapaneseCharacters: boolean;
- /**
- * Whether or not half-width characters should be converted to full-width characters.
- */
- convertHalfWidthCharacters: FindTermsVariantMode;
- /**
- * Whether or not ASCII numeric characters should be converted to full-width numeric characters.
- */
- convertNumericCharacters: FindTermsVariantMode;
- /**
- * Whether or not alphabetic characters should be converted to kana.
- */
- convertAlphabeticCharacters: FindTermsVariantMode;
- /**
- * Whether or not hiragana characters should be converted to katakana.
- */
- convertHiraganaToKatakana: FindTermsVariantMode;
- /**
- * Whether or not katakana characters should be converted to hiragana.
- */
- convertKatakanaToHiragana: FindTermsVariantMode;
- /**
- * How emphatic character sequences should be collapsed.
- */
- collapseEmphaticSequences: FindTermsEmphaticSequencesMode;
- /**
- * An iterable sequence of text replacements to be applied during the term lookup process.
- */
- textReplacements: Iterable<(FindTermsTextReplacement | null)> | null;
- /**
- * The mapping of dictionaries to search for terms in.
- * The key is the dictionary name.
- */
- enabledDictionaryMap: Map<string, FindTermDictionary>;
- /**
- * A set of dictionary names which should have definitions removed.
- */
- excludeDictionaryDefinitions: Set<string> | null;
- }
-
- /**
- * The matching type for looking up terms.
- */
- export enum FindTermsMatchType {
- Exact = 'exact',
- Prefix = 'prefix',
- Suffix = 'suffix',
- }
-
- /**
- * A sorting order to use when finding terms.
- */
- export enum FindTermsSortOrder {
- Ascending = 'ascending',
- Descending = 'descending',
- }
-
- /**
- * Mode describing how to handle variations.
- */
- export enum FindTermsVariantMode {
- False = 'false',
- True = 'true',
- Variant = 'variant',
- }
-
- /**
- * Mode describing how to handle emphatic sequence variations.
- */
- export enum FindTermsEmphaticSequencesMode {
- False = 'false',
- True = 'true',
- Full = 'full',
- }
-
- /**
- * Information about how text should be replaced when looking up terms.
- */
- export interface FindTermsTextReplacement {
- /**
- * The pattern to replace.
- */
- pattern: RegExp;
- /**
- * The replacement string. This can contain special sequences, such as `$&`.
- */
- replacement: string;
- }
-
- /**
- * Details about a dictionary.
- */
- export interface FindTermDictionary {
- /**
- * The index of the dictionary
- */
- index: number;
- /**
- * The priority of the dictionary
- */
- priority: number;
- /**
- * Whether or not secondary term searches are allowed for this dictionary.
- */
- allowSecondarySearches: boolean;
- }
-}