> ## 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 grade level appropriateness:

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

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

await evaluator.evaluate(text);
```

## Text Complexity evaluator family

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

* [Grade Level Appropriateness](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md)
* [Subject Matter Knowledge](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md)  v0.2.0
* [Vocabulary](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md)
* [Sentence Structure](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md)
* [Conventionality](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md)  v0.3.0
* [Purpose](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md)  v0.5.0

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](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md#output) | [`GradeLevelAppropriatenessInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/grade-level-appropriateness.ts) ↗ |
| [Subject Matter Knowledge](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md)v0.2.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md#output) | [`SmkInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/smk.ts) ↗ |
| [Vocabulary](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md#output) | [`VocabularyInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/vocabulary.ts) ↗ |
| [Sentence Structure](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md#output) | [`SentenceStructureInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/sentence-structure.ts) ↗ |
| [Conventionality](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md)v0.3.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md#output) | [`ConventionalityInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/conventionality.ts) ↗ |
| [Purpose](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md)v0.5.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md#output) | [`PurposeInternal`](https://github.com/learning-commons-org/evaluators/blob/5c83b885a4f53a061ebb4ec75f7c520ee7cb3b01/sdks/typescript/src/schemas/purpose.ts) ↗ |