spiegel-keyman/common/models/types
Marc Durdin 767927bf16 chore(common): use /usr/bin/env bash
Fixes up scripts (except under /linux) to use `#!/usr/bin/env bash`
instead of `#!/bin/bash` or `#!/bin/sh` so that we don't end up with
the ancient version of bash supplied with macOS.

This became urgent with this PR, because of bash-4.xisms in
build-utils.sh, for example on line 572:

```
if [[ -v _builder_params[$e] ]]; then
```
2022-07-25 14:59:37 +10:00
..
.gitignore chore(web): replace lerna with npm workspaces and ts projects 2022-04-12 21:02:33 +10:00
build.sh chore(common): use /usr/bin/env bash 2022-07-25 14:59:37 +10:00
index.d.ts feat(web): prediction casing follows current layer 2022-04-08 16:14:01 +10:00
package.json chore(web): move version from package.json to keyman-version package 2022-04-17 06:47:39 +10:00
README.md chore(web): replace lerna with npm workspaces and ts projects 2022-04-12 21:02:33 +10:00
test.ts refactor(common/lmlayer): move @keymanapp/models-types to its new home 2020-05-19 19:14:15 -06:00
tsconfig.json chore(web): replace lerna with npm workspaces and ts projects 2022-04-12 21:02:33 +10:00

@keymanapp/models-types

Declares TypeScript types and interfaces required to define Lexical Models, Word breaking functions, and all things in between.

Install

(see below if you are working in the keymanapp/keyman repo!)

npm install --save-dev @keymanapp/models-types

Usage

Say you are creating a custom lexical model. Then import this module in your lexical model file!

// my-nifty-model.ts

import "@keymanapp/models-types";

export class MyNiftyClass implements LexicalModel {
  configure(capabilities: Capabilities): Configuration {
    // TODO: implement me!
    throw new Error("Method not implemented.");
  }
  predict(transform: Transform, context: Context): ProbabilityMass<Suggestion>[] {
    // TODO: implement me!
    throw new Error("Method not implemented.");
  }
  wordbreak(context: Context): string {
    // TODO: implement me!
    throw new Error("Method not implemented.");
  }
  punctuation?: LexicalModelPunctuation;
}

If your are creating a custom word breaker, you would do the same:

import "@keymanapp/models-types";

export let myShinyWordBreaker: WordBreakingFunction;
myShinyWordBreaker = function (phrase: string): Span[] {
  // TODO: implement me!
  throw new Error("Function not implemented")
}

Look at index.d.ts for documentation on each and every type!

Usage within keymanapp/keyman repo

To use it in other subprojects within keymanapp/keyman, ensure that this package is linked using "*". Add this dependency to your subproject like so:

  "dependencies": {
    "@keymanapp/models-types": "*",
  }