Skip to main content

Chat UI

Status: No dedicated documentation exists for the overall "chat-ui" organism in design-system-docs main (verified 2026-08-19). This is a factual scaffold, not real guidance — every qualitative section below is an explicit placeholder for a human writer. Nothing has been invented.

Note: Additional documentation for AIPreview and AIArtefact may be added separately under docs/components/chat-ui/ in the future. This file intentionally covers only the overall chat-ui organism and its key source references.

Source: DTSL/design-system → packages/product/organisms/chat-ui/src/ai-chat/ (package @dtsl/naos-chat-ui)

Real source content found: packages/product/organisms/chat-ui/ACCESSIBILITY_ANALYSIS.md is a genuine WCAG 2.1 AA accessibility analysis (dated 2026-06-05) covering every sub-component under ai-chat/ with severity-rated findings (🔴 critical / 🟡 moderate / 🔵 minor). Example real finding: ChatLog already has role="log", aria-live="polite", aria-relevant="additions", but is missing an aria-label on the log region (🟡 moderate, WCAG 2.4.6). This file should be the primary source for the real Accessibility section — it was not summarized further here to avoid transcription drift; read it directly when writing the real doc.

Sub-components have their own design/journal docs already in source (not summarized here, just located):

  • AIChatLog/ChatLog/2026-04-09-chatlog-chatmessage-design.md
  • AIChatLog/AIArtefact/Artifacts.journal.md
  • AIDrawer/ai-drawer.journal.md
  • AIPromptBox/PromptBox/promptBox.journal.md

Public export surface: src/index.ts only exports ai-chat at this shallow level — full component list not extracted here given the multi-sub-component structure; see source directly.

When to Use​

TODO — no existing UX/product guidance found for the organism as a whole. Needs input from design/PM.

When NOT to Use​

TODO — needs UX/product input.

Decision Logic​

TODO — needs UX/product input.

Accessibility​

Real findings exist in ACCESSIBILITY_ANALYSIS.md (see above) — pull directly from that file rather than re-deriving; it is dated and scoped (2026-06-05, static code review), so re-verify findings are still current before publishing.

Common Mistakes​

TODO — needs UX/product input.