# @fayegram-ai/faye-ui/tokens/contract

Public exports and dependency-resolved component properties, with usage and rendering guidance.

## Import

```tsx
import { contract } from '@fayegram-ai/faye-ui/tokens/contract';
```

[Usage and behavior guide](/docs/tokens/) · [API JSON](/api/packages/tokens/contract.json)

This entry has no declared client boundary; individual exported behavior still follows its rendering contract.

## Public exports

| Name | Kind | Resolved declaration type |
|---|---|---|
| `contract` | value | `{ readonly "color.canvas": { readonly type: "color"; readonly description: "color canvas"; readonly runtime: true; }; readonly "color.surface": { readonly type: "color"; readonly description: "color surface"; readonly runtime: true; }; readonly "color.raised": { readonly type: "color"; readonly description: "color raised"; readonly runtime: true; }; readonly "color.subtle": { readonly type: "color"; readonly description: "color subtle"; readonly runtime: true; }; readonly "color.hover": { readonly type: "color"; readonly description: "color hover"; readonly runtime: true; }; readonly "color.pressed": { readonly type: "color"; readonly description: "color pressed"; readonly runtime: true; }; readonly "color.text": { readonly type: "color"; readonly description: "color text"; readonly runtim… (full type in API JSON)` |
| `TokenName` | type | `"color.canvas" \| "color.surface" \| "color.raised" \| "color.subtle" \| "color.hover" \| "color.pressed" \| "color.text" \| "color.muted" \| "color.faint" \| "color.border" \| "color.border-strong" \| "color.accent" \| "color.accent-hover" \| "color.accent-soft" \| "color.on-accent" \| "color.focus" \| "color.danger" \| "color.danger-soft" \| "color.success" \| "color.success-soft" \| "color.warning" \| "color.warning-soft" \| "color.info" \| "color.info-soft" \| "color.backdrop" \| "font.body" \| "font.mono" \| "font.size-xs" \| "font.size-sm" \| "font.size-md" \| "font.size-lg" \| "font.size-xl" \| "font.size-2xl" \| "font.size-3xl" \| "font.size-4xl" \| "font.weight-normal" \| "font.weight-medium" \| "font.weight-semibold" \| "line.tight" \| "line.normal" \| "line.relaxed" \| "radius.none" \| "radius.sm" \| "radius.control" \| "… (full type in API JSON)` |



## Defaults and customization

Defaults and native behavior are documented in the linked family guide. This reference does not infer a default from an optional property.

Use semantic tokens, public part hooks and customization sheets. Keep visual configuration separate from application state.

## State, events and accessibility

For interactive controls, pair a controlled value/open prop with its corresponding change callback; default props initialize uncontrolled state. Keep application validation and submission policy explicit. Name controls with visible labels, name icon-only actions on the button, and preserve focus and dismissal behavior when replacing parts. Use native form names and submit/reset types where supported. See the usage guide for component-specific behavior and live examples.

## Declaration authority

Generated from `packages/faye-ui/dist/tokens/contract.d.ts` after the semantic package build. Common native/React attributes are intentionally omitted from property tables. Generic overloads, discriminated unions and complete inherited attributes remain authoritative in installed TypeScript declarations. [React DOM attributes](https://react.dev/reference/react-dom/components/common) and [Base UI component contracts](https://base-ui.com/react/overview/quick-start) describe the inherited foundations.