mirror of
https://github.com/keymanapp/keyman.git
synced 2026-08-14 12:49:25 +00:00
Remove suggestion, prediction, transform, and message interfaces for now.
This commit is contained in:
parent
49bd430818
commit
c591eedeeb
1 changed files with 0 additions and 172 deletions
|
|
@ -31,175 +31,3 @@
|
|||
* See also: https://developer.mozilla.org/en-US/docs/Web/API/USVString
|
||||
*/
|
||||
type USVString = string;
|
||||
|
||||
/**
|
||||
* Describes a potential change to a text buffer.
|
||||
*/
|
||||
interface Transform {
|
||||
/**
|
||||
* The Unicode scalar values (i.e., characters) to be inserted at the
|
||||
* cursor position.
|
||||
*
|
||||
* Corresponds to `s` in com.keyman.KeyboardInterface.output.
|
||||
*/
|
||||
insert: USVString;
|
||||
|
||||
/**
|
||||
* The number of code units to delete to the left of the cursor.
|
||||
*
|
||||
* Corresponds to `dn` in com.keyman.KeyboardInterface.output.
|
||||
*/
|
||||
delete: number;
|
||||
|
||||
/**
|
||||
* The number of code units to delete to the right of the cursor.
|
||||
* Not available on all platforms.
|
||||
*/
|
||||
deleteRight?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* A token
|
||||
*
|
||||
* TODO: this should be an opaque type!
|
||||
*/
|
||||
type Token = number;
|
||||
|
||||
/**
|
||||
* The different message kinds.
|
||||
*/
|
||||
type MessageKind = 'initialize' | 'ready' | 'predict' | 'suggestions';
|
||||
|
||||
type Message = InitializeMessage
|
||||
| ReadyMessage
|
||||
| PredictMessage
|
||||
| SuggestionsMessage;
|
||||
|
||||
interface InitializeMessage {
|
||||
message: 'initialize';
|
||||
/**
|
||||
* Path to the model. There are no concrete restrictions on the path
|
||||
* to the model, so long as the LMLayer can successfully use it to
|
||||
* initialize the model.
|
||||
*/
|
||||
model: string;
|
||||
configuration: {
|
||||
/**
|
||||
* Whether the platform supports right contexts.
|
||||
* The absence of this rule implies false.
|
||||
*/
|
||||
supportsRightContexts?: false,
|
||||
|
||||
/**
|
||||
* Whether the platform supports deleting to the right.
|
||||
* The absence of this rule implies false.
|
||||
*/
|
||||
supportsDeleteRight?: false,
|
||||
|
||||
/**
|
||||
* The maximum amount of UTF-16 code units that the keyboard will
|
||||
* provide to the left of the cursor.
|
||||
*/
|
||||
maxLeftContextCodeUnits: 32,
|
||||
|
||||
/**
|
||||
* The maximum amount of code units that the keyboard will provide to
|
||||
* the right of the cursor. The absence of this rule implies 0.
|
||||
* See also, [[supportsRightContexts]].
|
||||
*/
|
||||
maxRightContextCodeUnits: 32,
|
||||
}
|
||||
}
|
||||
|
||||
interface ReadyMessage {
|
||||
message: 'ready';
|
||||
configuration: {
|
||||
/**
|
||||
* How many UTF-16 code units maximum to send as the context to the
|
||||
* left of the cursor ("left" in the Unicode character stream).
|
||||
*
|
||||
* Affects the `context` property sent in `predict` messages.
|
||||
*
|
||||
* While the left context MUST NOT bisect surrogate pairs, they MAY
|
||||
* bisect graphical clusters.
|
||||
*/
|
||||
leftContextCodeUnits: number,
|
||||
|
||||
/**
|
||||
* How many UTF-16 code units maximum to send as the context to the
|
||||
* right of the cursor ("right" in the Unicode character stream).
|
||||
*
|
||||
* Affects the `context` property sent in `predict` messages.
|
||||
*
|
||||
* While the left context MUST NOT bisect surrogate pairs, they MAY
|
||||
* bisect graphical clusters.
|
||||
*/
|
||||
rightContextCodeUnits: number,
|
||||
};
|
||||
}
|
||||
|
||||
interface PredictMessage {
|
||||
message: 'predict';
|
||||
token: Token;
|
||||
context: Context;
|
||||
transform: Transform;
|
||||
}
|
||||
|
||||
interface SuggestionsMessage {
|
||||
message: 'suggestions';
|
||||
token: Token;
|
||||
/**
|
||||
* An ordered array of [[Suggestion]] objects.
|
||||
* The suggestions are ordered from most probable, to least
|
||||
* probable. In practice, only a handful of suggestions can
|
||||
* be display on the screen, depending on the language. Plan
|
||||
* to produce the top three suggestions.
|
||||
*/
|
||||
suggestions: Suggestion[];
|
||||
}
|
||||
|
||||
/**
|
||||
* The context is the text surrounding the insertion point,
|
||||
* before any transforms are applied to the text buffer.
|
||||
*/
|
||||
interface Context {
|
||||
/**
|
||||
* Up to maxLeftContextCodeUnits code units of Unicode scalar value
|
||||
* (i. e., characters) to the left of the insertion point in the
|
||||
* buffer. If there is nothing to the left of the buffer, this returns
|
||||
* an empty string.
|
||||
*/
|
||||
left: USVString;
|
||||
|
||||
/**
|
||||
* Up to maxRightContextCodeUnits code units of Unicode scalar value
|
||||
* (i. e., characters) to the right of the insertion point in the
|
||||
* buffer. If there is nothing to the right of the buffer, this returns
|
||||
* an empty string.
|
||||
*/
|
||||
right?: USVString;
|
||||
|
||||
/**
|
||||
* Whether the insertion point is at the start of the buffer.
|
||||
*/
|
||||
startOfBuffer: boolean;
|
||||
|
||||
/**
|
||||
* Whether the insertion point is at the end of the buffer.
|
||||
*/
|
||||
endOfBuffer: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* A suggested change. Bundles the suggested [[Transform]], along
|
||||
* with a way to display it on the screen.
|
||||
*/
|
||||
interface Suggestion {
|
||||
transform: Transform;
|
||||
/**
|
||||
* A string to display the suggestion to the typist.
|
||||
* This should aid the typist understand what the transform
|
||||
* will do to their text.
|
||||
*/
|
||||
displayAs: string;
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue