id: dark
kind: theme
name: Dark
description: Inverted-luminance theme for low-light surfaces and user preference.

colorScheme: dark

metadata:
  status: {status: stable}
  since: 1.2.0
  tags: [theme]

refs:
  - to: light
    rel: extends
  - href: tokens/dark.tokens.json
    rel: file
    note: DTCG source for this theme's token overrides - the specific tokens that differ from `light` are whichever this file redeclares.

sections:
  - kind: guidelines
    for: human
    items:
      - statement: Apply via the root color-scheme attribute, never per-component overrides.
        level: must
      - statement: Respect prefers-color-scheme unless the user has set an explicit preference.
        level: should
