Reasoning

API and Development

Import Reasoning from @prepared911/ui/reasoning.

Reasoning

Prop	Type	Default	Notes
`label`	`LocalizedMessage`	required	Trigger label when complete, for example "Thought for 12s".
`streamingLabel`	`LocalizedMessage`		Trigger label while streaming, for example "Thinking…". Falls back to `label`.
`isStreaming`	`boolean`	`false`	Shows the streaming label in a Shimmer with a sparkle; starts open.
`open`	`boolean`		Controlled open state.
`defaultOpen`	`boolean`	`isStreaming`	Initial open state when uncontrolled; read on the first render only.
`onOpenChange`	`(open: boolean, details: ChangeDetails) => void`		Reason is `trigger-press`.
`className`	`string`		Appended to the root.
`children`	`ReactNode`		The reasoning, in the disclosed region.

Props

Name	Type	Default	Description
`label`	`LocalizedMessage`	—	Trigger label when the reasoning is complete, for example "Thought for 12s". The caller formats any elapsed time, because the design system ships no translation runtime ([ADR 0009](../../../docs/decisions/0009-copy-prop-types.md)).
`children`	`ReactNode`	—	The assistant's reasoning, shown in the disclosed region. Block content is allowed.
`className`	`string`	—	Classes appended to the root.
`defaultOpen`	`boolean`	—	Initial open state when uncontrolled. Defaults to {@link ReasoningProps.isStreaming} on the first render.
`isStreaming`	`boolean`	`false`	The reasoning is still arriving. The trigger shows the streaming label in a Shimmer with a leading sparkle, and the region starts open unless `defaultOpen` says otherwise.
`onOpenChange`	`CollapsibleOpenChangeHandler`	—	Fires when the trigger requests a change. `details.cancel()` keeps the current state.
`open`	`boolean`	—	Controlled open state.
`streamingLabel`	`LocalizedMessage`	—	Trigger label while {@link ReasoningProps.isStreaming} is true, for example "Thinking…". Falls back to `label`.

Storybook

Interactive examples and edge cases for this component are in Storybook.

On this page

API and Development

Import Reasoning from @prepared911/ui/reasoning.

Reasoning

Prop	Type	Default	Notes
`label`	`LocalizedMessage`	required	Trigger label when complete, for example "Thought for 12s".
`streamingLabel`	`LocalizedMessage`		Trigger label while streaming, for example "Thinking…". Falls back to `label`.
`isStreaming`	`boolean`	`false`	Shows the streaming label in a Shimmer with a sparkle; starts open.
`open`	`boolean`		Controlled open state.
`defaultOpen`	`boolean`	`isStreaming`	Initial open state when uncontrolled; read on the first render only.
`onOpenChange`	`(open: boolean, details: ChangeDetails) => void`		Reason is `trigger-press`.
`className`	`string`		Appended to the root.
`children`	`ReactNode`		The reasoning, in the disclosed region.

Props

Name	Type	Default	Description
`label`	`LocalizedMessage`	—	Trigger label when the reasoning is complete, for example "Thought for 12s". The caller formats any elapsed time, because the design system ships no translation runtime ([ADR 0009](../../../docs/decisions/0009-copy-prop-types.md)).
`children`	`ReactNode`	—	The assistant's reasoning, shown in the disclosed region. Block content is allowed.
`className`	`string`	—	Classes appended to the root.
`defaultOpen`	`boolean`	—	Initial open state when uncontrolled. Defaults to {@link ReasoningProps.isStreaming} on the first render.
`isStreaming`	`boolean`	`false`	The reasoning is still arriving. The trigger shows the streaming label in a Shimmer with a leading sparkle, and the region starts open unless `defaultOpen` says otherwise.
`onOpenChange`	`CollapsibleOpenChangeHandler`	—	Fires when the trigger requests a change. `details.cancel()` keeps the current state.
`open`	`boolean`	—	Controlled open state.
`streamingLabel`	`LocalizedMessage`	—	Trigger label while {@link ReasoningProps.isStreaming} is true, for example "Thinking…". Falls back to `label`.

Storybook

Interactive examples and edge cases for this component are in Storybook.

On this page