/* Semantic aliases. Reach for these first; drop to base tokens only
   when no alias says what you mean. */
:root{
  /* Text */
  --text-heading:var(--black);
  --text-body:var(--gray-1);
  --text-secondary:var(--gray-2);
  --text-muted:var(--gray-3);
  --text-accent:var(--orange);
  --text-on-dark:var(--on-dark-1);
  --text-on-dark-secondary:var(--on-dark-2);
  --text-error:var(--red);

  /* Surfaces */
  --surface-page:var(--white);
  --surface-card:var(--gray-5);
  --surface-band:var(--gray-5);
  --surface-dark:var(--black);
  --surface-hero:var(--grad-dark);
  --surface-callout:linear-gradient(135deg,var(--orange-dim),transparent);

  /* Lines */
  --border-default:var(--gray-4);
  --border-subtle:var(--gray-5);
  --border-strong:var(--black);
  --border-on-dark:var(--hairline-dark);
  --accent-rule:var(--orange);

  /* Controls */
  --btn-primary-bg:var(--orange);
  --btn-primary-bg-hover:var(--orange-hover);
  --btn-primary-fg:var(--white);
  --btn-secondary-border:var(--gray-4);
  --btn-secondary-fg:var(--black);
  --btn-dark-bg:var(--black);
  --focus-ring:var(--orange);
  --focus-ring-soft:var(--orange-ring);
  --field-border:var(--gray-4);
  --field-border-focus:var(--orange);
  --field-placeholder:var(--gray-3);
}