@oddkin/ai 0.0.0-stage → 1.0.0-beta.1

package/agent/references/components/odd-transcript.md

@@ -0,0 +1,69 @@
+# `<odd-transcript>` (OddkinTranscript)
+
+Package `@oddkin/ai` 1.0.0-beta.1 · category AI. Generated from `custom-elements.json` and `oddkin.metadata.json`; facts are extracted unless marked authored or verified.
+
+A transcript with final segments (optionally editable) and interim text that may still change.
+
+## Import and register
+
+- Register: `import '@oddkin/ai/define/transcript';`
+- Class: `import { OddkinTranscript } from '@oddkin/ai/transcript';`
+
+## Properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `segments` | none: assign as a property | { id: string; text: string; final: boolean; speaker?: string \| undefined; }[] | [] | Final (and interim) segments. |
+| `interim` | none: assign as a property | string | '' | Current interim text. |
+| `editable` | `editable` (reflects) | boolean | false | Final segments can be corrected. |
+| `strings` | none: assign as a property | Partial<{ label: string; listening: string; empty: string; edit: string; }> \| undefined | undefined | Localized string overrides. |
+
+## Events
+
+| Event | Type | Intent | Description |
+| --- | --- | --- | --- |
+| `odd-transcript-change` | CustomEvent<{ readonly segmentId: string; readonly text: string; }> | user (authored) | The user edited a final transcript segment. |
+
+## Slots
+
+None.
+
+## Parts
+
+| Name | Description |
+| --- | --- |
+| `interim` | Interim text. |
+| `list` | Final segments. |
+
+## CSS custom properties
+
+None.
+
+## Custom states
+
+None.
+
+## Guidance (authored)
+
+- Use for: Showing and correcting speech-to-text results. (src/transcript/transcript.ts:20)
+- Not for: Chat transcripts; use the conversation. (src/transcript/transcript.ts:21)
+- Accessibility: Not a live region: interim text changes constantly. Final segments are ordinary text or labelled text areas when editable. (src/transcript/transcript.ts:18)
+- Keyboard: Editable segments are native text areas. (src/transcript/transcript.ts:19)
+
+## Examples
+
+- `example:odd-transcript/default` in src/transcript/transcript.examples.ts (package source)
+
+## Customization
+
+- Levels: 1, 2 (authored)
+
+## Contracts
+
+- `contract:core/binding-rule`
+- `contract:core/properties`
+- `contract:core/events`
+- `contract:core/lifecycle`
+- `contract:core/update-complete`
+- `contract:core/scope`
+- `contract:core/composition`

package/agent/references/components/odd-usage-meter.md

@@ -0,0 +1,67 @@
+# `<odd-usage-meter>` (OddkinUsageMeter)
+
+Package `@oddkin/ai` 1.0.0-beta.1 · category AI. Generated from `custom-elements.json` and `oddkin.metadata.json`; facts are extracted unless marked authored or verified.
+
+Token, context, quota, and cost figures exactly as the host supplies them, each marked
+measured, estimated, or unknown. Never computes or guesses a value.
+
+## Import and register
+
+- Register: `import '@oddkin/ai/define/usage-meter';`
+- Class: `import { OddkinUsageMeter } from '@oddkin/ai/usage-meter';`
+
+## Properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `usage` | none: assign as a property | { label: string; kind: "other" \| "input-tokens" \| "output-tokens" \| "context" \| "quota" \| "cost"; precision: "measured" \| "estimated" \| "unknown"; used?: number \| undefined; limit?: number \| undefined; unit?: string \| undefined; currency?: string \| undefined; }[] | [] | Usage entries (replace to update). |
+| `label` | `label` | string | '' | Accessible name; defaults to the localized "Usage". |
+| `strings` | none: assign as a property | Partial<{ label: string; ofLimit: string; unknown: string; estimated: string; measured: string; noLimit: string; }> \| undefined | undefined | Localized string overrides. |
+
+## Events
+
+None.
+
+## Slots
+
+None.
+
+## Parts
+
+| Name | Description |
+| --- | --- |
+| `list` | The description list of entries. |
+| `meter` | A native meter, only when both `used` and `limit` are known. |
+
+## CSS custom properties
+
+None.
+
+## Custom states
+
+None.
+
+## Guidance (authored)
+
+- Use for: Showing consumption of tokens, context window, quota, or cost. (src/usage-meter/usage-meter.ts:21)
+- Not for: Billing statements; amounts are informational. (src/usage-meter/usage-meter.ts:22)
+- Accessibility: Values are text; meters repeat them for sighted users and are labelled by their entry. (src/usage-meter/usage-meter.ts:20)
+- Limitations: Precision labels come from the host (`measured` / `estimated` / `unknown`). (src/usage-meter/usage-meter.ts:23)
+
+## Examples
+
+- `example:odd-usage-meter/default` in src/usage-meter/usage-meter.examples.ts (package source)
+
+## Customization
+
+- Levels: 1, 2 (authored)
+
+## Contracts
+
+- `contract:core/binding-rule`
+- `contract:core/properties`
+- `contract:core/events`
+- `contract:core/lifecycle`
+- `contract:core/update-complete`
+- `contract:core/scope`
+- `contract:core/composition`

package/agent/references/components/odd-voice-input.md

@@ -0,0 +1,76 @@
+# `<odd-voice-input>` (OddkinVoiceInput)
+
+Package `@oddkin/ai` 1.0.0-beta.1 · category AI. Generated from `custom-elements.json` and `oddkin.metadata.json`; facts are extracted unless marked authored or verified.
+
+Voice capture with transcription: start, stop (keep), and cancel (discard), with permission,
+device, interruption, and processing states. Uses a replaceable `VoiceAdapter`; an element
+that creates its own controller releases the microphone when disconnected.
+
+## Import and register
+
+- Register: `import '@oddkin/ai/define/voice-input';`
+- Class: `import { OddkinVoiceInput } from '@oddkin/ai/voice-input';`
+- Dependency (transcript): `<odd-transcript>`
+
+## Properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `adapter` | none: assign as a property | VoiceAdapter \| undefined | undefined | Capture and transcription adapter (owned controller only). |
+| `controller` | none: assign as a property | VoiceController \| undefined | undefined | Host-owned controller; the host also owns its cleanup. |
+| `disabled` | `disabled` (reflects) | boolean | false | Voice input is unavailable (e.g. capability off). |
+| `strings` | none: assign as a property | Partial<{ start: string; stop: string; cancel: string; use: string; clear: string; unsupported: string; idle: string; 'requesting-permission': string; recording: string; processing: string; denied: string; unavailable: string; interrupted: string; error: string; }> \| undefined | undefined | Localized string overrides. |
+| `activeController` | none (read-only) | VoiceController |  | The controller in use (host-supplied or owned). |
+
+## Events
+
+| Event | Type | Intent | Description |
+| --- | --- | --- | --- |
+| `odd-voice-transcript` | CustomEvent<{ readonly text: string; }> | user (authored) | A final transcript is ready to use (completed locally). |
+| `odd-announce` | CustomEvent<AnnounceDetail> | notification (authored) | A status message for the nearest announcer, which cancels it so outer announcers stay silent. |
+
+## Slots
+
+None.
+
+## Parts
+
+| Name | Description |
+| --- | --- |
+| `base` | The column of the controls, the status, and the transcript. |
+| `controls` | Record, cancel, and use controls. |
+| `status` | Status text. |
+
+## CSS custom properties
+
+None.
+
+## Custom states
+
+None.
+
+## Guidance (authored)
+
+- Use for: Dictating prompts or notes. (src/voice-input/voice-input.ts:35)
+- Not for: Audio recording for its own sake. (src/voice-input/voice-input.ts:36)
+- Accessibility: The record control is a toggle button (`aria-pressed`). Status changes (denied, interrupted) are announced once through the surface's announcer; interim text is never announced. (src/voice-input/voice-input.ts:33)
+- Keyboard: Enter or Space starts and stops recording; Escape cancels while recording. (src/voice-input/voice-input.ts:34)
+- Limitations: Capability depends on the adapter: browser speech recognition, a recorder plus host transcription, or a scripted adapter. (src/voice-input/voice-input.ts:37)
+
+## Examples
+
+- `example:odd-voice-input/default` in src/voice-input/voice-input.examples.ts (package source)
+
+## Customization
+
+- Levels: 1, 2 (authored)
+
+## Contracts
+
+- `contract:core/binding-rule`
+- `contract:core/properties`
+- `contract:core/events`
+- `contract:core/lifecycle`
+- `contract:core/update-complete`
+- `contract:core/scope`
+- `contract:core/composition`

package/agent/references/models/oddkin.ai.approval.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.approval v1
+
+Id `model:oddkin.ai.approval`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.approval.v1.json`.

package/agent/references/models/oddkin.ai.artifact.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.artifact v1
+
+Id `model:oddkin.ai.artifact`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.artifact.v1.json`.

package/agent/references/models/oddkin.ai.checkpoint.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.checkpoint v1
+
+Id `model:oddkin.ai.checkpoint`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.checkpoint.v1.json`.

package/agent/references/models/oddkin.ai.context-item.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.context-item v1
+
+Id `model:oddkin.ai.context-item`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.context-item.v1.json`.

package/agent/references/models/oddkin.ai.conversation.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.conversation v1
+
+Id `model:oddkin.ai.conversation`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.conversation.v1.json`.

package/agent/references/models/oddkin.ai.feedback.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.feedback v1
+
+Id `model:oddkin.ai.feedback`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.feedback.v1.json`.

package/agent/references/models/oddkin.ai.message.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.message v1
+
+Id `model:oddkin.ai.message`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.message.v1.json`.

package/agent/references/models/oddkin.ai.model-option.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.model-option v1
+
+Id `model:oddkin.ai.model-option`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.model-option.v1.json`.

package/agent/references/models/oddkin.ai.plan.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.plan v1
+
+Id `model:oddkin.ai.plan`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.plan.v1.json`.

package/agent/references/models/oddkin.ai.question.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.question v1
+
+Id `model:oddkin.ai.question`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.question.v1.json`.

package/agent/references/models/oddkin.ai.suggestion.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.suggestion v1
+
+Id `model:oddkin.ai.suggestion`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.suggestion.v1.json`.

package/agent/references/models/oddkin.ai.tool-call.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.tool-call v1
+
+Id `model:oddkin.ai.tool-call`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.tool-call.v1.json`.

package/agent/references/models/oddkin.ai.transcript-segment.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.transcript-segment v1
+
+Id `model:oddkin.ai.transcript-segment`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.transcript-segment.v1.json`.

package/agent/references/models/oddkin.ai.usage.md

@@ -0,0 +1,3 @@
+# Model oddkin.ai.usage v1
+
+Id `model:oddkin.ai.usage`. JSON Schema: `@oddkin/ai/schemas/oddkin.ai.usage.v1.json`.

package/agent/references/recipes/action-approval.md

@@ -0,0 +1,12 @@
+# Recipe action-approval
+
+Id `recipe:action-approval`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `changes` | stack |
+| `change` | row |
+| `reason` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/activity.md

@@ -0,0 +1,9 @@
+# Recipe activity
+
+Id `recipe:activity`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/ai-element.md

@@ -0,0 +1,9 @@
+# Recipe ai-element
+
+Id `recipe:ai-element`.
+
+| Region | Helper |
+| --- | --- |
+| `actions` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/artifact.md

@@ -0,0 +1,10 @@
+# Recipe artifact
+
+Id `recipe:artifact`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `header` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/change-review.md

@@ -0,0 +1,11 @@
+# Recipe change-review
+
+Id `recipe:change-review`.
+
+| Region | Helper |
+| --- | --- |
+| `list` | stack |
+| `proposal` | stack |
+| `split` | autoGrid |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/checkpoint.md

@@ -0,0 +1,10 @@
+# Recipe checkpoint
+
+Id `recipe:checkpoint`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `confirm` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/citation.md

@@ -0,0 +1,9 @@
+# Recipe citation
+
+Id `recipe:citation`.
+
+| Region | Helper |
+| --- | --- |
+| `preview` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/context-picker.md

@@ -0,0 +1,12 @@
+# Recipe context-picker
+
+Id `recipe:context-picker`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `list` | stack |
+| `row` | row |
+| `url` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/conversation.md

@@ -0,0 +1,12 @@
+# Recipe conversation
+
+Id `recipe:conversation`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `feed` | stack |
+| `history` | row |
+| `empty` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/inline-assist.md

@@ -0,0 +1,11 @@
+# Recipe inline-assist
+
+Id `recipe:inline-assist`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `toolbar` | row |
+| `language` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/message.md

@@ -0,0 +1,12 @@
+# Recipe message
+
+Id `recipe:message`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `header` | row |
+| `content` | stack |
+| `edit` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/prompt-input.md

@@ -0,0 +1,12 @@
+# Recipe prompt-input
+
+Id `recipe:prompt-input`.
+
+| Region | Helper |
+| --- | --- |
+| `toolbar` | row |
+| `attachments` | row |
+| `issues` | stack |
+| `attachment` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/question.md

@@ -0,0 +1,12 @@
+# Recipe question
+
+Id `recipe:question`.
+
+| Region | Helper |
+| --- | --- |
+| `form` | stack |
+| `options` | stack |
+| `option` | row |
+| `field` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/response-feedback.md

@@ -0,0 +1,12 @@
+# Recipe response-feedback
+
+Id `recipe:response-feedback`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `form` | stack |
+| `check` | row |
+| `field` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/sources.md

@@ -0,0 +1,10 @@
+# Recipe sources
+
+Id `recipe:sources`.
+
+| Region | Helper |
+| --- | --- |
+| `list` | stack |
+| `item` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/suggestions.md

@@ -0,0 +1,9 @@
+# Recipe suggestions
+
+Id `recipe:suggestions`.
+
+| Region | Helper |
+| --- | --- |
+| `list` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/task-plan.md

@@ -0,0 +1,15 @@
+# Recipe task-plan
+
+Id `recipe:task-plan`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+| `progress` | row |
+| `steps` | stack |
+| `tasks` | stack |
+| `step` | row |
+| `task` | row |
+| `body` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/tool-call.md

@@ -0,0 +1,11 @@
+# Recipe tool-call
+
+Id `recipe:tool-call`.
+
+| Region | Helper |
+| --- | --- |
+| `summary` | row |
+| `body` | stack |
+| `failure` | row |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/transcript.md

@@ -0,0 +1,9 @@
+# Recipe transcript
+
+Id `recipe:transcript`.
+
+| Region | Helper |
+| --- | --- |
+| `list` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/usage-meter.md

@@ -0,0 +1,9 @@
+# Recipe usage-meter
+
+Id `recipe:usage-meter`.
+
+| Region | Helper |
+| --- | --- |
+| `list` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/recipes/voice-input.md

@@ -0,0 +1,9 @@
+# Recipe voice-input
+
+Id `recipe:voice-input`.
+
+| Region | Helper |
+| --- | --- |
+| `base` | stack |
+
+Layers: recipe.base → recipe.variant → recipe.condition.

package/agent/references/tokens/component.md

@@ -0,0 +1,13 @@
+# Tokens: component
+
+Theme `default`, modes light, dark. From the theme's token inspection.
+
+| Token | CSS variable | Type | Value | Defined as | Origin |
+| --- | --- | --- | --- | --- | --- |
+| `card.padding` | `--odd-card-padding` | dimension | 1.5rem | alias of `layout.inset` | preset |
+| `card.radius` | `--odd-card-radius` | dimension | 0.75rem | alias of `radius.lg` | preset |
+| `navigation.indent` | `--odd-navigation-indent` | dimension | 1rem | alias of `space.md` | preset |
+| `navigation.item.gap` | `--odd-navigation-item-gap` | dimension | 0.5rem | alias of `space.xs` | preset |
+| `navigation.item.min-height` | `--odd-navigation-item-min-height` | dimension | 2.5rem | alias of `control.height.md` | preset |
+| `navigation.item.padding.block` | `--odd-navigation-item-padding-block` | dimension | 0.5rem | alias of `space.xs` | preset |
+| `navigation.item.padding.inline` | `--odd-navigation-item-padding-inline` | dimension | 0.75rem | alias of `space.sm` | preset |

package/agent/references/tokens/foundation.md

@@ -0,0 +1,73 @@
+# Tokens: foundation
+
+Theme `default`, modes light, dark. From the theme's token inspection.
+
+| Token | CSS variable | Type | Value | Defined as | Origin |
+| --- | --- | --- | --- | --- | --- |
+| `border.width.default` | `--odd-border-width-default` | dimension | 1px | 1px | preset |
+| `border.width.strong` | `--odd-border-width-strong` | dimension | 2px | 2px | preset |
+| `elevation.lg` | `--odd-elevation-lg` | shadow | light: 0 4px 8px rgb(0 0 0 / 0.08), 0 12px 32px rgb(0 0 0 / 0.14); dark: 0 4px 8px rgb(0 0 0 / 0.32), 0 12px 32px rgb(0 0 0 / 0.48) | light: 0 4px 8px rgb(0 0 0 / 0.08), 0 12px 32px rgb(0 0 0 / 0.14); dark: 0 4px 8px rgb(0 0 0 / 0.32), 0 12px 32px rgb(0 0 0 / 0.48) | preset |
+| `elevation.md` | `--odd-elevation-md` | shadow | light: 0 1px 2px rgb(0 0 0 / 0.12), 0 4px 12px rgb(0 0 0 / 0.08); dark: 0 1px 2px rgb(0 0 0 / 0.4), 0 4px 12px rgb(0 0 0 / 0.32) | light: 0 1px 2px rgb(0 0 0 / 0.12), 0 4px 12px rgb(0 0 0 / 0.08); dark: 0 1px 2px rgb(0 0 0 / 0.4), 0 4px 12px rgb(0 0 0 / 0.32) | preset |
+| `elevation.none` | `--odd-elevation-none` | shadow | none | none | preset |
+| `elevation.sm` | `--odd-elevation-sm` | shadow | light: 0 1px 2px rgb(0 0 0 / 0.08), 0 1px 3px rgb(0 0 0 / 0.08); dark: 0 1px 2px rgb(0 0 0 / 0.3), 0 1px 3px rgb(0 0 0 / 0.3) | light: 0 1px 2px rgb(0 0 0 / 0.08), 0 1px 3px rgb(0 0 0 / 0.08); dark: 0 1px 2px rgb(0 0 0 / 0.3), 0 1px 3px rgb(0 0 0 / 0.3) | preset |
+| `elevation.xl` | `--odd-elevation-xl` | shadow | light: 0 8px 16px rgb(0 0 0 / 0.1), 0 24px 64px rgb(0 0 0 / 0.2); dark: 0 8px 16px rgb(0 0 0 / 0.4), 0 24px 64px rgb(0 0 0 / 0.6) | light: 0 8px 16px rgb(0 0 0 / 0.1), 0 24px 64px rgb(0 0 0 / 0.2); dark: 0 8px 16px rgb(0 0 0 / 0.4), 0 24px 64px rgb(0 0 0 / 0.6) | preset |
+| `focus.offset` | `--odd-focus-offset` | dimension | 2px | 2px | preset |
+| `focus.width` | `--odd-focus-width` | dimension | 2px | 2px | preset |
+| `font.family.display` | `--odd-font-family-display` | fontFamily | system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | alias of `font.family.sans` | preset |
+| `font.family.mono` | `--odd-font-family-mono` | fontFamily | ui-monospace, SFMono-Regular, Menlo, Consolas, monospace | ui-monospace, SFMono-Regular, Menlo, Consolas, monospace | preset |
+| `font.family.sans` | `--odd-font-family-sans` | fontFamily | system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | preset |
+| `font.size.2xl` | `--odd-font-size-2xl` | dimension | 1.5rem | 1.5rem | preset |
+| `font.size.3xl` | `--odd-font-size-3xl` | dimension | 1.875rem | 1.875rem | preset |
+| `font.size.4xl` | `--odd-font-size-4xl` | dimension | 2.25rem | 2.25rem | preset |
+| `font.size.lg` | `--odd-font-size-lg` | dimension | 1.125rem | 1.125rem | preset |
+| `font.size.md` | `--odd-font-size-md` | dimension | 1rem | 1rem | preset |
+| `font.size.sm` | `--odd-font-size-sm` | dimension | 0.875rem | 0.875rem | preset |
+| `font.size.xl` | `--odd-font-size-xl` | dimension | 1.25rem | 1.25rem | preset |
+| `font.size.xs` | `--odd-font-size-xs` | dimension | 0.75rem | 0.75rem | preset |
+| `font.weight.bold` | `--odd-font-weight-bold` | fontWeight | 700 | 700 | preset |
+| `font.weight.medium` | `--odd-font-weight-medium` | fontWeight | 500 | 500 | preset |
+| `font.weight.regular` | `--odd-font-weight-regular` | fontWeight | 400 | 400 | preset |
+| `font.weight.semibold` | `--odd-font-weight-semibold` | fontWeight | 600 | 600 | preset |
+| `icon.size.lg` | `--odd-icon-size-lg` | dimension | 1.5rem | 1.5rem | preset |
+| `icon.size.md` | `--odd-icon-size-md` | dimension | 1.25rem | 1.25rem | preset |
+| `icon.size.sm` | `--odd-icon-size-sm` | dimension | 1rem | 1rem | preset |
+| `letter-spacing.normal` | `--odd-letter-spacing-normal` | dimension | 0 | 0 | preset |
+| `letter-spacing.tight` | `--odd-letter-spacing-tight` | dimension | -0.025em | -0.025em | preset |
+| `letter-spacing.wide` | `--odd-letter-spacing-wide` | dimension | 0.05em | 0.05em | preset |
+| `line-height.none` | `--odd-line-height-none` | number | 1 | 1 | preset |
+| `line-height.normal` | `--odd-line-height-normal` | number | 1.5 | 1.5 | preset |
+| `line-height.relaxed` | `--odd-line-height-relaxed` | number | 1.625 | 1.625 | preset |
+| `line-height.snug` | `--odd-line-height-snug` | number | 1.375 | 1.375 | preset |
+| `line-height.tight` | `--odd-line-height-tight` | number | 1.25 | 1.25 | preset |
+| `motion.duration.fast` | `--odd-motion-duration-fast` | duration | 100ms | 100ms | preset |
+| `motion.duration.normal` | `--odd-motion-duration-normal` | duration | 200ms | 200ms | preset |
+| `motion.duration.slow` | `--odd-motion-duration-slow` | duration | 300ms | 300ms | preset |
+| `motion.duration.slower` | `--odd-motion-duration-slower` | duration | 500ms | 500ms | preset |
+| `motion.easing.enter` | `--odd-motion-easing-enter` | cubicBezier | cubic-bezier(0, 0, 0.2, 1) | cubic-bezier(0, 0, 0.2, 1) | preset |
+| `motion.easing.exit` | `--odd-motion-easing-exit` | cubicBezier | cubic-bezier(0.4, 0, 1, 1) | cubic-bezier(0.4, 0, 1, 1) | preset |
+| `motion.easing.linear` | `--odd-motion-easing-linear` | cubicBezier | cubic-bezier(0, 0, 1, 1) | cubic-bezier(0, 0, 1, 1) | preset |
+| `motion.easing.standard` | `--odd-motion-easing-standard` | cubicBezier | cubic-bezier(0.4, 0, 0.2, 1) | cubic-bezier(0.4, 0, 0.2, 1) | preset |
+| `radius.2xl` | `--odd-radius-2xl` | dimension | 1.5rem | 1.5rem | preset |
+| `radius.full` | `--odd-radius-full` | dimension | 9999px | 9999px | preset |
+| `radius.lg` | `--odd-radius-lg` | dimension | 0.75rem | 0.75rem | preset |
+| `radius.md` | `--odd-radius-md` | dimension | 0.5rem | 0.5rem | preset |
+| `radius.none` | `--odd-radius-none` | dimension | 0 | 0 | preset |
+| `radius.sm` | `--odd-radius-sm` | dimension | 0.25rem | 0.25rem | preset |
+| `radius.xl` | `--odd-radius-xl` | dimension | 1rem | 1rem | preset |
+| `radius.xs` | `--odd-radius-xs` | dimension | 0.125rem | 0.125rem | preset |
+| `space.2xl` | `--odd-space-2xl` | dimension | 3rem | 3rem | preset |
+| `space.2xs` | `--odd-space-2xs` | dimension | 0.25rem | 0.25rem | preset |
+| `space.3xl` | `--odd-space-3xl` | dimension | 4rem | 4rem | preset |
+| `space.3xs` | `--odd-space-3xs` | dimension | 0.125rem | 0.125rem | preset |
+| `space.4xl` | `--odd-space-4xl` | dimension | 6rem | 6rem | preset |
+| `space.lg` | `--odd-space-lg` | dimension | 1.5rem | 1.5rem | preset |
+| `space.md` | `--odd-space-md` | dimension | 1rem | 1rem | preset |
+| `space.none` | `--odd-space-none` | dimension | 0 | 0 | preset |
+| `space.sm` | `--odd-space-sm` | dimension | 0.75rem | 0.75rem | preset |
+| `space.xl` | `--odd-space-xl` | dimension | 2rem | 2rem | preset |
+| `space.xs` | `--odd-space-xs` | dimension | 0.5rem | 0.5rem | preset |
+| `target.min` | `--odd-target-min` | dimension | 1.5rem | 1.5rem | preset |
+| `z-index.base` | `--odd-z-index-base` | number | 0 | 0 | preset |
+| `z-index.overlay` | `--odd-z-index-overlay` | number | 200 | 200 | preset |
+| `z-index.raised` | `--odd-z-index-raised` | number | 1 | 1 | preset |
+| `z-index.sticky` | `--odd-z-index-sticky` | number | 100 | 100 | preset |

package/agent/references/tokens/layout.md

@@ -0,0 +1,12 @@
+# Tokens: layout
+
+Theme `default`, modes light, dark. From the theme's token inspection.
+
+| Token | CSS variable | Type | Value | Defined as | Origin |
+| --- | --- | --- | --- | --- | --- |
+| `layout.gap` | `--odd-layout-gap` | dimension | 1rem | alias of `space.md` | preset |
+| `layout.inset` | `--odd-layout-inset` | dimension | 1.5rem | alias of `space.lg` | preset |
+| `layout.item-min` | `--odd-layout-item-min` | dimension | 16rem | 16rem | preset |
+| `layout.main-min` | `--odd-layout-main-min` | dimension | 20rem | 20rem | preset |
+| `layout.measure` | `--odd-layout-measure` | dimension | 40rem | 40rem | preset |
+| `layout.sidebar-width` | `--odd-layout-sidebar-width` | dimension | 16rem | 16rem | preset |