4 definitions in this file:

 Machine-readable value name (e.g., 'sm', 'md', 'lg', 'primary', 'secondary'). What this value looks like, when to use it, and how it differs from other values in this dimension. Human-readable name (e.g., 'Small', 'Medium', 'Large', 'Primary', 'Secondary'). Why this flag exists — the user need or design rationale it addresses (e.g., 'Prevents user interaction during form submission to avoid duplicate requests'). Visual previews showing this variant value in isolation or in context. References: richText, purpose, example Identifies this variant as a boolean flag. Machine-readable name of the flag (e.g., 'disabled', 'full-width', 'icon-only', 'loading'). What this flag controls and how it affects the component's appearance or behavior when active. Human-readable name of the flag (e.g., 'Disabled', 'Full Width', 'Icon Only', 'Loading'). Why this variant exists — the user need or design rationale it addresses (e.g., 'Prevents user interaction during form submission to avoid duplicate requests'). Visual preview showing the component with this flag active. References: richText, purpose, example Identifies this variant as an enumerated set of values. Machine-readable name of the variant dimension (e.g., 'size', 'emphasis', 'shape'). This is the axis name, not a value within it. What this dimension of variation controls and how its values affect the component's appearance or behavior. The possible values for this variant. Must contain at least two entries — a single-value dimension should be modeled as a flag variant instead. Ordering is significant — tools SHOULD preserve it for display.
Min items: 2 Human-readable name of the variant dimension (e.g., 'Size', 'Emphasis', 'Shape'). References: richText, variantValue Identifies this guideline as a variants spec. The variant dimensions. Each item is either a flag (boolean toggle) or an enum (set of values). Ordering is significant — tools SHOULD display dimensions in this order.
Min items: 1 Agent-optimized context for this document block. Provides structured information for AI/LLM consumption — constraints, disambiguation, anti-patterns, examples, and keywords. References: flagVariant, enumVariant, agents

Design System Documentation Standard (DSDS) 0.1 — Draft Specification

GitHub