entasis 0.12.0 → 0.13.1

package/dist/components/Form/TimeInput/timeInput.theme.d.ts

@@ -1,6 +1,6 @@
 import { type InferComponentTheme } from '../../../utils/cva/index.js';
 export declare const timeInputTheme: {
-    input: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    input: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -10,8 +10,8 @@ export declare const timeInputTheme: {
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    inputContainer: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    inputContainer: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -21,19 +21,19 @@ export declare const timeInputTheme: {
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    popover: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    picker: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerColumn: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerLabel: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    popover: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    picker: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerColumn: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerLabel: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
             large: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    pickerScrollArea: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerOption: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    pickerScrollArea: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerOption: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -43,12 +43,12 @@ export declare const timeInputTheme: {
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
 };
 export type TimeInputTheme = typeof timeInputTheme;
 export type TimeInputThemeProps = InferComponentTheme<TimeInputTheme>;
 export declare const setTimeInputTheme: (theme: InferComponentTheme<{
-    input: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    input: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -58,8 +58,8 @@ export declare const setTimeInputTheme: (theme: InferComponentTheme<{
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    inputContainer: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    inputContainer: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -69,19 +69,19 @@ export declare const setTimeInputTheme: (theme: InferComponentTheme<{
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    popover: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    picker: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerColumn: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerLabel: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    popover: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    picker: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerColumn: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerLabel: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
             large: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    pickerScrollArea: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerOption: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    pickerScrollArea: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerOption: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -91,10 +91,10 @@ export declare const setTimeInputTheme: (theme: InferComponentTheme<{
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
 }>) => void;
-export declare const useTimeInputTheme: import("../../../utils/cva/theme.js").UseComponentTheme<{
-    input: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+export declare const useTimeInputTheme: import("../../../utils/cva/theme.ts").UseComponentTheme<{
+    input: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -104,8 +104,8 @@ export declare const useTimeInputTheme: import("../../../utils/cva/theme.js").Us
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    inputContainer: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    inputContainer: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -115,19 +115,19 @@ export declare const useTimeInputTheme: import("../../../utils/cva/theme.js").Us
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    popover: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    picker: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerColumn: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerLabel: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    popover: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    picker: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerColumn: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerLabel: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
             large: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
-    pickerScrollArea: (props?: import("../../../utils/cva/types.js").CVAClassProp | undefined) => string;
-    pickerOption: (props?: (import("../../../utils/cva/types.js").CVAVariantSchema<{
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
+    pickerScrollArea: (props?: import("../../../utils/cva/types.ts").CVAClassProp | undefined) => string;
+    pickerOption: (props?: (import("../../../utils/cva/types.ts").CVAVariantSchema<{
         size: {
             small: string;
             normal: string;
@@ -137,5 +137,5 @@ export declare const useTimeInputTheme: import("../../../utils/cva/theme.js").Us
             true: string;
             false: string;
         };
-    }> & import("../../../utils/cva/types.js").CVAClassProp) | undefined) => string;
+    }> & import("../../../utils/cva/types.ts").CVAClassProp) | undefined) => string;
 }>;

package/dist/components/Form/VoiceInput/VoiceInput.svelte

@@ -35,6 +35,7 @@
 		onStart,
 		onStop,
 		onError,
+		inlineError = true,
 		visible,
 		color,
 		size = 'normal',
@@ -153,10 +154,12 @@
 
 	const classes = $derived(useVoiceInputTheme(theme));
 	const hasPlayback = $derived(!!field.value && !recorder.isRecording && !recorder.isStopping);
+	// An error the control shows itself; with `inlineError={false}` the surrounding UI reports it.
+	const shownError = $derived(inlineError ? recorder.errorMessage : null);
 	const isExpanded = $derived.by(() => {
 		if (variant === 'default') return true;
-		if (variant === 'compact') return !!recorder.errorMessage;
-		return hasPlayback || recorder.isRecording || recorder.isStopping || !!recorder.errorMessage;
+		if (variant === 'compact') return !!shownError;
+		return hasPlayback || recorder.isRecording || recorder.isStopping || !!shownError;
 	});
 	const fieldTheme = $derived({
 		...(theme || {}),
@@ -189,7 +192,7 @@
 		recorder.isPlaying ? (pauseLabel ?? t.voiceInputPause) : (playLabel ?? t.voiceInputPlay)
 	);
 	const statusMessage = $derived.by(() => {
-		if (recorder.errorMessage) return recorder.errorMessage;
+		if (shownError) return shownError;
 		if (recorder.status === 'requesting') return t.voiceInputStatusRequesting;
 		if (recorder.isRecording) return t.voiceInputStatusRecording;
 		if (recorder.isStopping) return t.voiceInputStatusFinishing;
@@ -226,6 +229,7 @@
 >
 	{#if hasPlayback}
 		<FieldActionButton
+			tabbable
 			id={`${id}-playback`}
 			{size}
 			color={recorder.isPlaying ? resolvedColor : 'neutral'}
@@ -259,6 +263,7 @@
 	/>
 	{#if hasPlayback}
 		<FieldActionButton
+			tabbable
 			id={`${id}-clear`}
 			{size}
 			color="danger"
@@ -276,6 +281,7 @@
 		/>
 	{/if}
 	<FieldActionButton
+		tabbable
 		{id}
 		{size}
 		color={recorder.isRecording ? resolvedColor : 'neutral'}
@@ -285,6 +291,7 @@
 		class={classes.action({
 			size,
 			variant,
+			expanded: isExpanded,
 			recording: recorder.isRecording,
 			class: theme?.action?.base
 		})}

package/dist/components/Form/VoiceInput/voiceInput.mcp.d.ts

@@ -1 +1 @@
-export declare const voiceInputDescription = "\n# VoiceInput Component\n\nVoiceInput records microphone audio into a bindable Blob, renders live microphone feedback, and previews the finalized recording with a seekable waveform. It can stay full width, expand leftward during capture, or remain mic-only with level-responsive rings.\n\n## Import\n\n```svelte\n<script lang=\"ts\">\n\timport { VoiceInput } from 'entasis/voice-input';\n</script>\n```\n\n## Basic usage\n\n```svelte\n<script lang=\"ts\">\n\timport { VoiceInput } from 'entasis/voice-input';\n\n\tlet recording = $state<Blob | null>(null);\n\tlet duration = $state(0);\n</script>\n\n<VoiceInput\n\tlabel=\"Voice note\"\n\tbind:value={recording}\n\tbind:duration\n\tminDuration={1}\n\tmaxDuration={60}\n/>\n```\n\n## Props\n\n- **value**: `Blob | null` (bindable, default: `null`) - Finalized microphone recording. Starting a successful new recording or using Clear removes the previous value.\n- **defaultValue**: `Blob | null` (default: `null`) - Initial recording used only when `value` is omitted.\n- **duration**: `number` (bindable, default: `0`) - Current or finalized duration in seconds.\n- **minDuration**: `number` (default: `0`) - Minimum accepted finalized duration in seconds. Shorter recordings surface a Field validation error.\n- **maxDuration**: `number | undefined` - Maximum duration in seconds. Recording stops automatically at this limit.\n- **color**: `Colors` (default: `'primary'`) - Focus and active recording color.\n- **variant**: `'default' | 'expandable' | 'compact'` (default: `'default'`) - Keeps the waveform full width, expands it only while recording or previewing, or renders a mic-only level indicator.\n- **size**: `'small' | 'normal' | 'large'` (default: `'normal'`) - Control height, waveform height, timer size, and action size.\n- **disabled**: `boolean` (default: `false`) - Prevents microphone, playback, seeking, and clear interactions.\n- **readOnly**: `boolean` (default: `false`) - Disables recording and clearing while the recorded value still validates and submits.\n- **required**: `boolean` (default: `false`) - Requires a recorded Blob during Field/Form validation.\n- **startLabel**: `string` (default: `'Start voice recording'`) - Start-button accessible label and tooltip.\n- **stopLabel**: `string` (default: `'Stop recording'`) - Stop-button accessible label and tooltip.\n- **playLabel**: `string` (default: `'Play recording'`) - Playback-button label and tooltip while paused.\n- **pauseLabel**: `string` (default: `'Pause recording'`) - Playback-button label and tooltip while playing.\n- **seekLabel**: `string` (default: `'Seek recording'`) - Accessible label for the finalized waveform seek control.\n- **clearLabel**: `string` (default: `'Clear recording'`) - Clear-button accessible label and tooltip.\n- **onValueChange**: `(value: Blob | null) => void` - Runs when the field value changes, including Clear.\n- **onStart**: `() => void` - Runs after microphone capture starts.\n- **onStop**: `({ blob, duration }: VoiceInputResult) => void` - Runs after MediaRecorder finalizes the recording.\n- **onError**: `(error: Error) => void` - Runs when permission, recording, or playback fails.\n- **theme**: `VoiceInputThemeProps & FieldThemeProps` - Overrides voice-input and inherited Field theme parts.\n\nVoiceInput also accepts the standard Field props and slots, including `label`, `description`, `helper`, errors, and attachments.\n\n## Form configuration\n\n```svelte\n<Form\n\tinputs={{\n\t\tmessage: {\n\t\t\ttype: 'voice',\n\t\t\tlabel: 'Voice message',\n\t\t\trequired: true,\n\t\t\tminDuration: 1,\n\t\t\tmaxDuration: 60\n\t\t}\n\t}}\n\tonSubmit={(value) => uploadVoiceMessage(value.message)}\n/>\n```\n\n## Behavior\n\n- The waveform is drawn on a responsive canvas and maps live microphone RMS through a logarithmic decibel scale so quiet speech remains visible.\n- New samples enter from the right and push older samples left.\n- `maxDuration` schedules a hard automatic stop and caps the published duration at the configured limit.\n- `minDuration` participates in normal Field validation after MediaRecorder publishes the final Blob.\n- The `expandable` variant has no hidden full-width footprint while collapsed, then anchors the action on the right and animates the waveform surface toward the left while recording, finalizing, or previewing saved audio.\n- The `compact` variant omits the waveform and timer, uses a solid active surface while recording, and scales two concentric rings with the same logarithmic microphone level.\n- Finalized recordings expose play/pause and clear actions. The saved waveform becomes a native range-based playback timeline with elapsed progress, pointer scrubbing, and keyboard seeking.\n- Clear pauses playback, revokes the Blob URL, resets duration and waveform state, and publishes `null` through the normal field value contract.\n- Playback creates its Blob URL lazily and revokes it when the value changes or the component unmounts.\n- Stopping waits for MediaRecorder's final `dataavailable` event before publishing the Blob.\n- Starting another recording replaces the previous value only once microphone setup succeeds.\n- Permission denial, missing microphones, and unsupported browser APIs are surfaced in the control and through `onError`.\n- Microphone tracks, cutoff timers, animation frames, audio graph nodes, observers, and the AudioContext are released on stop, failure, or unmount.\n\n## Accessibility\n\n- The visible field label targets the current microphone/stop button.\n- Microphone, stop, play, pause, and clear actions have accessible labels and tooltips.\n- Recording and playback state changes are announced through a polite live region without announcing the timer every second.\n- Operational errors use `role=\"alert\"`; duration requirements use the inherited Field error rendering.\n- The canvas is decorative and hidden from assistive technology. A transparent native range input exposes the finalized waveform as a labelled slider with elapsed and total time.\n- Compact rings are decorative pseudo-elements and add no accessibility-tree content.\n\n## Browser requirements\n\nMicrophone capture requires a secure context (HTTPS, with localhost allowed by browsers), user permission, MediaRecorder, and Web Audio API support.\n\n## Theme parts\n\n- `root` - Field root and variant width behavior.\n- `inputContainer` - Input-like recording surface.\n- `content` - Waveform, operational error, and timer region.\n- `action` - Microphone/stop action, including compact level rings.\n- `playbackAction` - Play/pause action shown for a finalized recording.\n- `clearAction` - Clear action shown for a finalized recording.\n- `waveformContainer` - Relative live/playback waveform surface and focus treatment.\n- `waveform` - Responsive visual canvas.\n- `waveformInput` - Native range hitbox layered over a finalized waveform.\n- `timer` - Stable tabular duration.\n- `error` - Operational error message.\n\n## State contract\n\n- **value**: current bindable editable value.\n- **defaultValue**: initial value used only when `value` is omitted.\n- **onValueChange**: called with the new value when the component changes it.\n\n";
+export declare const voiceInputDescription = "\n# VoiceInput Component\n\nVoiceInput records microphone audio into a bindable Blob, renders live microphone feedback, and previews the finalized recording with a seekable waveform. It can stay full width, expand leftward during capture, or remain mic-only with level-responsive rings.\n\n## Import\n\n```svelte\n<script lang=\"ts\">\n\timport { VoiceInput } from 'entasis/voice-input';\n</script>\n```\n\n## Basic usage\n\n```svelte\n<script lang=\"ts\">\n\timport { VoiceInput } from 'entasis/voice-input';\n\n\tlet recording = $state<Blob | null>(null);\n\tlet duration = $state(0);\n</script>\n\n<VoiceInput\n\tlabel=\"Voice note\"\n\tbind:value={recording}\n\tbind:duration\n\tminDuration={1}\n\tmaxDuration={60}\n/>\n```\n\n## Props\n\n- **value**: `Blob | null` (bindable, default: `null`) - Finalized microphone recording. Starting a successful new recording or using Clear removes the previous value.\n- **defaultValue**: `Blob | null` (default: `null`) - Initial recording used only when `value` is omitted.\n- **duration**: `number` (bindable, default: `0`) - Current or finalized duration in seconds.\n- **minDuration**: `number` (default: `0`) - Minimum accepted finalized duration in seconds. Shorter recordings surface a Field validation error.\n- **maxDuration**: `number | undefined` - Maximum duration in seconds. Recording stops automatically at this limit.\n- **color**: `Colors` (default: `'primary'`) - Focus and active recording color.\n- **variant**: `'default' | 'expandable' | 'compact'` (default: `'default'`) - Keeps the waveform full width, expands it only while recording or previewing, or renders a mic-only level indicator.\n- **size**: `'small' | 'normal' | 'large'` (default: `'normal'`) - Control height, waveform height, timer size, and action size.\n- **disabled**: `boolean` (default: `false`) - Prevents microphone, playback, seeking, and clear interactions.\n- **readOnly**: `boolean` (default: `false`) - Disables recording and clearing while the recorded value still validates and submits.\n- **required**: `boolean` (default: `false`) - Requires a recorded Blob during Field/Form validation.\n- **startLabel**: `string` (default: `'Start voice recording'`) - Start-button accessible label and tooltip.\n- **stopLabel**: `string` (default: `'Stop recording'`) - Stop-button accessible label and tooltip.\n- **playLabel**: `string` (default: `'Play recording'`) - Playback-button label and tooltip while paused.\n- **pauseLabel**: `string` (default: `'Pause recording'`) - Playback-button label and tooltip while playing.\n- **seekLabel**: `string` (default: `'Seek recording'`) - Accessible label for the finalized waveform seek control.\n- **clearLabel**: `string` (default: `'Clear recording'`) - Clear-button accessible label and tooltip.\n- **onValueChange**: `(value: Blob | null) => void` - Runs when the field value changes, including Clear.\n- **onStart**: `() => void` - Runs after microphone capture starts.\n- **onStop**: `({ blob, duration }: VoiceInputResult) => void` - Runs after MediaRecorder finalizes the recording.\n- **onError**: `(error: Error) => void` - Runs when permission, recording, or playback fails.\n- **inlineError**: `boolean` (default `true`) - Shows a failure inside the control (a `compact` or `expandable` voice input expands to hold the message). `false` keeps the control its size with only the danger border, for UI that reports `onError` itself (AIComposer shows it in its error banner).\n- **theme**: `VoiceInputThemeProps & FieldThemeProps` - Overrides voice-input and inherited Field theme parts.\n\nVoiceInput also accepts the standard Field props and slots, including `label`, `description`, `helper`, errors, and attachments.\n\n## Form configuration\n\n```svelte\n<Form\n\tinputs={{\n\t\tmessage: {\n\t\t\ttype: 'voice',\n\t\t\tlabel: 'Voice message',\n\t\t\trequired: true,\n\t\t\tminDuration: 1,\n\t\t\tmaxDuration: 60\n\t\t}\n\t}}\n\tonSubmit={(value) => uploadVoiceMessage(value.message)}\n/>\n```\n\n## Behavior\n\n- The waveform is drawn on a responsive canvas and maps live microphone RMS through a logarithmic decibel scale so quiet speech remains visible.\n- New samples enter from the right and push older samples left.\n- `maxDuration` schedules a hard automatic stop and caps the published duration at the configured limit.\n- `minDuration` participates in normal Field validation after MediaRecorder publishes the final Blob.\n- The `expandable` variant has no hidden full-width footprint while collapsed, then anchors the action on the right and animates the waveform surface toward the left while recording, finalizing, or previewing saved audio.\n- The `compact` variant omits the waveform and timer, uses a solid active surface while recording, and scales two concentric rings with the same logarithmic microphone level.\n- Finalized recordings expose play/pause and clear actions. The saved waveform becomes a native range-based playback timeline with elapsed progress, pointer scrubbing, and keyboard seeking.\n- Clear pauses playback, revokes the Blob URL, resets duration and waveform state, and publishes `null` through the normal field value contract.\n- Playback creates its Blob URL lazily and revokes it when the value changes or the component unmounts.\n- Stopping waits for MediaRecorder's final `dataavailable` event before publishing the Blob.\n- Starting another recording replaces the previous value only once microphone setup succeeds.\n- Permission denial, missing microphones, and unsupported browser APIs are surfaced in the control and through `onError`.\n- Microphone tracks, cutoff timers, animation frames, audio graph nodes, observers, and the AudioContext are released on stop, failure, or unmount.\n\n## Accessibility\n\n- The visible field label targets the current microphone/stop button.\n- Microphone, stop, play, pause, and clear actions have accessible labels and tooltips.\n- Recording and playback state changes are announced through a polite live region without announcing the timer every second.\n- Operational errors use `role=\"alert\"`; duration requirements use the inherited Field error rendering.\n- The canvas is decorative and hidden from assistive technology. A transparent native range input exposes the finalized waveform as a labelled slider with elapsed and total time.\n- Compact rings are decorative pseudo-elements and add no accessibility-tree content.\n\n## Browser requirements\n\nMicrophone capture requires a secure context (HTTPS, with localhost allowed by browsers), user permission, MediaRecorder, and Web Audio API support.\n\n## Theme parts\n\n- `root` - Field root and variant width behavior.\n- `inputContainer` - Input-like recording surface.\n- `content` - Waveform, operational error, and timer region.\n- `action` - Microphone/stop action, including compact level rings.\n- `playbackAction` - Play/pause action shown for a finalized recording.\n- `clearAction` - Clear action shown for a finalized recording.\n- `waveformContainer` - Relative live/playback waveform surface and focus treatment.\n- `waveform` - Responsive visual canvas.\n- `waveformInput` - Native range hitbox layered over a finalized waveform.\n- `timer` - Stable tabular duration.\n- `error` - Operational error message.\n\n## State contract\n\n- **value**: current bindable editable value.\n- **defaultValue**: initial value used only when `value` is omitted.\n- **onValueChange**: called with the new value when the component changes it.\n\n";

package/dist/components/Form/VoiceInput/voiceInput.mcp.js

@@ -53,6 +53,7 @@ VoiceInput records microphone audio into a bindable Blob, renders live microphon
 - **onStart**: \`() => void\` - Runs after microphone capture starts.
 - **onStop**: \`({ blob, duration }: VoiceInputResult) => void\` - Runs after MediaRecorder finalizes the recording.
 - **onError**: \`(error: Error) => void\` - Runs when permission, recording, or playback fails.
+- **inlineError**: \`boolean\` (default \`true\`) - Shows a failure inside the control (a \`compact\` or \`expandable\` voice input expands to hold the message). \`false\` keeps the control its size with only the danger border, for UI that reports \`onError\` itself (AIComposer shows it in its error banner).
 - **theme**: \`VoiceInputThemeProps & FieldThemeProps\` - Overrides voice-input and inherited Field theme parts.
 
 VoiceInput also accepts the standard Field props and slots, including \`label\`, \`description\`, \`helper\`, errors, and attachments.

package/dist/components/Form/VoiceInput/voiceInput.props.d.ts

@@ -42,6 +42,14 @@ export type VoiceInputProps = WithAttachments<Omit<InputProps<'voice'>, 'onValue
     onStop?: (payload: VoiceInputResult) => void;
     /** Called when microphone access or recording fails. */
     onError?: (error: Error) => void;
+    /**
+     * Shows a microphone or recording failure inside the control: a `compact` or `expandable`
+     * voice input expands to hold the message. Set `false` where the surrounding UI reports
+     * `onError` itself (AIComposer does, in its error banner): the control then stays its size
+     * and only takes the danger border.
+     * @default true
+     */
+    inlineError?: boolean;
     /** Theme overrides for the voice input and inherited Field parts. */
     theme?: VoiceInputThemeProps & InputProps<'voice'>['theme'];
 }>;