# Dialogue Presentation Guide

The dialogue subsystem now exposes renderer-neutral presentation data for
cinematic conversations and accessible dialogue UI.

## Cinematic Plans

- `createDialogueCameraPlan` builds over-the-shoulder, shot-reverse-shot,
  close-up, extreme close-up, medium, and wide shots, then selects the active
  shot from dialogue tags and node type.
- `createDialogueStagingPlan` positions speakers and listeners with idle
  speaking/listening animation hints and facing targets.
- `createDialogueCinematicBlendPlan` describes the transition from gameplay
  camera to dialogue shot and back.

## Performance Cues

- `createDialogueLipSyncPlan` maps dialogue text and voice-over assets to
  phoneme timing cues.
- `createDialogueFacialExpressionPlan` turns emotion metadata and tags into
  facial blend weights.
- `createDialogueGesturePlan` turns tags such as `[nod]`, `[point]`, and
  `[important]` into actor gesture cues.
- `createDialogueAmbientAnimationPlan` supplies looped breathing, fidget, and
  look-around cues for participants.

## UI, Audio, and Accessibility

- `createDialogueAudioPlaybackPlan` resolves voice-over clips, sound cues,
  subtitle timing, and music/ambient ducking.
- `createDialogueUIViewModel` exposes speaker, portrait, text, choices, and
  continue/auto-advance state for dialogue UI.
- `createDialogueSubtitleCues` emits speaker subtitles and non-verbal captions.
- `skipDialogue` supports skipping the current line, skipping to the next
  choice, or ending the conversation.
- `createDialogueLog` creates a scrollable conversation history from dialogue
  history entries.
- `createDialogueEditorGraph` exports a visual node graph for editor previews.
- `createDialogueAccessibleViewModel` applies text scale, background opacity,
  auto-advance, and TTS settings.
