Remove suggestion, prediction, transform, and message interfaces for now.

This commit is contained in:
Eddie Antonio Santos 2018-11-27 10:57:36 -07:00
parent 49bd430818
commit c591eedeeb
No known key found for this signature in database
GPG key ID: DD411EA4D9509D87

View file

@ -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;
}