# Component contract worksheet

Blank working document. Replace placeholders with your own evidence; an empty field is unknown, not a passing result.

Owner: [fill in]
Source revision: [fill in]
Environment: [fill in]
Evidence date: [fill in]

## Current API

Component/revision: ___
React version: ___
Consumers: ___
Coupled flags and defaults: ___

## Variant map

| Current combination | Intended variant | Required invariant | Existing test |
| --- | --- | --- | --- |
| ___ | ___ | ___ | ___ |

## Proposed contract

Public composition: ___
State/actions/metadata ownership: ___
Invalid state prevented: ___
Added complexity and reason: ___

## Migration proof

Consumers changed: ___
Interaction/typecheck command and result: not run
Breaking changes: ___
Deferred consumers: ___

## Boundaries

- Composition guidance includes version-specific React APIs. Do not upgrade the framework merely to copy an example.

- The type reviewer’s numeric rubric is subjective; use concrete invariants and compiler/test evidence. Its inherited tools need host restrictions for a review-only pass.

Workflow: https://undominated.ai/workflows/#refactor-a-component-contract

Original worksheet: MIT. Linked resources retain their own licences and setup requirements.