> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Outputs

> Constructor options and outputs for evaluators using the TypeScript SDK.

Once you've configured your evaluator, you can start evaluating text inputs for a grade level:

```typescript example.ts theme={null}
const evaluator = new VocabularyEvaluator(configurationOptions);

const text = "The cat's out of the bag now.";
const grade = "5";

await evaluator.evaluate(text, grade);
```

## Literacy evaluators family

The Text Complexity Evaluator runs multiple literacy evaluators on the provided text input:

* [Grade Level Appropriateness](/evaluators/literacy-evaluators/grade-level-appropriateness)
* [Subject Matter Knowledge](/evaluators/literacy-evaluators/subject-matter-knowledge)  <Badge color="green">v0.2.0</Badge>
* [Vocabulary](/evaluators/literacy-evaluators/vocabulary)
* [Sentence Structure](/evaluators/literacy-evaluators/sentence-structure)
* [Conventionality](/evaluators/literacy-evaluators/conventionality)  <Badge color="green">v0.3.0</Badge>
* [Purpose](/evaluators/literacy-evaluators/purpose)  <Badge color="green">v0.5.0</Badge>

The output:

* Throws an error if all literacy evaluators fail
* Otherwise outputs an error or result [for each literacy evaluator](#for-other-evaluators)

## For other evaluators

All literacy evaluators besides the parent Text Complexity Evaluator have the following output fields.

| Field       | Type                                                                                                                           | Description                                                                                                                                                                       |
| :---------- | :----------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `score`     | [`TextComplexityLevel`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/outputs.ts) ↗ | Complexity classification returned by the evaluator. Purpose evaluator also accepts "More context needed" for cases where the text alone is insufficient to determine complexity. |
| `reasoning` | `string`                                                                                                                       | Explanation for the assigned complexity score                                                                                                                                     |
| `metadata`  | [`EvaluationMetadata`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/outputs.ts) ↗  | Includes model used to generate the evaluation, total evaluation processing time in milliseconds, input tokens, and output tokens.                                                |
| `_internal` | Unique to each evaluator                                                                                                       | Detailed internal analysis data specific to each evaluator.                                                                                                                       |

The `_internal` field includes detailed internal analysis data specific to that evaluator:

| Evaluator                                                                                                                                                     | `_internal` description                                                             | `_internal` type                                                                                                                                                 |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Grade Level Appropriateness](/evaluators/literacy-evaluators/grade-level-appropriateness)                                                                    | [Output fields](/evaluators/literacy-evaluators/grade-level-appropriateness#output) | [`GradeLevelAppropriatenessInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/grade-level-appropriateness.ts) ↗ |
| [Subject Matter Knowledge](/evaluators/literacy-evaluators/subject-matter-knowledge)<div style={{marginTop: '5px'}}><Badge color="green">v0.2.0</Badge></div> | [Output fields](/evaluators/literacy-evaluators/subject-matter-knowledge#output)    | [`SmkInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/smk.ts) ↗                                               |
| [Vocabulary](/evaluators/literacy-evaluators/vocabulary)                                                                                                      | [Output fields](/evaluators/literacy-evaluators/vocabulary#output)                  | [`VocabularyInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/vocabulary.ts) ↗                                 |
| [Sentence Structure](/evaluators/literacy-evaluators/sentence-structure)                                                                                      | [Output fields](/evaluators/literacy-evaluators/sentence-structure#output)          | [`SentenceStructureInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/sentence-structure.ts) ↗                  |
| [Conventionality](/evaluators/literacy-evaluators/conventionality)<div style={{marginTop: '5px'}}><Badge color="green">v0.3.0</Badge></div>                   | [Output fields](/evaluators/literacy-evaluators/conventionality#output)             | [`ConventionalityInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/conventionality.ts) ↗                       |
| [Purpose](/evaluators/literacy-evaluators/purpose)<div style={{marginTop: '5px'}}><Badge color="green">v0.5.0</Badge></div>                                   | [Output fields](/evaluators/literacy-evaluators/purpose#output)                     | [`PurposeInternal`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/purpose.ts) ↗                                       |