/* =============================================================================
   Cartopian Web - Page Templates
   -----------------------------------------------------------------------------
   Template-level layouts for TASK-01-004. This stylesheet layers on top of
   css/tokens.css, css/grid.css, and css/shell.css.
   ============================================================================= */

.template-page {
  background: var(--color-bg-page);
}

.site-nav__link[aria-current="page"] {
  color: var(--nav-link-active);
  background: var(--color-bg-subtle);
}

.template-band {
  background: var(--color-bg-subtle);
}

.template-section-header {
  max-inline-size: var(--container-md);
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
}

.template-eyebrow {
  margin: var(--space-0);
  color: var(--color-text-brand);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-bold);
  line-height: var(--line-height-tight);
  letter-spacing: var(--letter-spacing-wide);
  text-transform: uppercase;
}

.template-title {
  margin: var(--space-0);
  color: var(--color-text-primary);
  font-family: var(--font-family-heading);
  font-size: var(--font-size-3xl);
  font-weight: var(--font-weight-bold);
  line-height: var(--line-height-tight);
  letter-spacing: var(--letter-spacing-normal);
}

.template-title--display {
  font-size: var(--font-size-3xl);
}

.template-lede {
  max-inline-size: var(--container-md);
  margin: var(--space-0);
  color: var(--color-text-secondary);
  font-size: var(--font-size-md);
  line-height: var(--line-height-relaxed);
}

.template-copy {
  margin: var(--space-0);
  color: var(--color-text-secondary);
}

.template-actions {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-3);
}

.template-button {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-block-size: var(--space-12);
  padding: var(--button-padding-y) var(--button-padding-x);
  border: var(--space-px) solid var(--button-secondary-border);
  border-radius: var(--button-radius);
  font-size: var(--font-size-sm);
  font-weight: var(--button-font-weight);
  line-height: var(--line-height-tight);
  text-align: center;
  text-decoration: none;
  transition:
    background var(--duration-fast) var(--easing-standard),
    border-color var(--duration-fast) var(--easing-standard),
    color var(--duration-fast) var(--easing-standard);
}

.template-button--primary {
  color: var(--button-primary-text);
  border-color: var(--button-primary-bg);
  background: var(--button-primary-bg);
  transition:
    background var(--duration-fast) var(--easing-standard),
    border-color var(--duration-fast) var(--easing-standard),
    color var(--duration-fast) var(--easing-standard),
    transform var(--duration-fast) var(--easing-standard);
}

.template-button--primary:hover {
  color: var(--button-primary-text);
  border-color: var(--button-primary-bg-hover);
  background: var(--button-primary-bg-hover);
  transform: translateY(-2px);
}

.template-button--secondary {
  color: var(--button-secondary-text);
  border-color: var(--button-secondary-border);
  background: var(--button-secondary-bg);
}

.template-button--secondary:hover {
  color: var(--color-link-hover);
  border-color: var(--color-link-hover);
}

.template-card {
  min-block-size: var(--space-32);
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  padding: var(--card-padding);
  border: var(--space-px) solid var(--card-border);
  border-radius: var(--card-radius);
  background: var(--card-bg);
  box-shadow: var(--card-shadow);
}

.template-card--compact {
  min-block-size: auto;
}

.template-card--vignette {
  min-block-size: auto;
  gap: var(--space-6);
}

.template-card-link {
  display: block;
  block-size: 100%;
  border-radius: var(--card-radius);
  color: inherit;
  text-decoration: none;
  outline-offset: var(--space-1);
}

.template-card-link .template-card {
  block-size: 100%;
  transition:
    background var(--duration-fast) var(--easing-standard),
    border-color var(--duration-fast) var(--easing-standard),
    transform var(--duration-fast) var(--easing-standard);
}

.template-card-link:hover .template-card,
.template-card-link:focus-visible .template-card {
  border-color: var(--color-border-strong);
  background: var(--color-bg-subtle);
  transform: translateY(-2px);
}

.template-card-link:hover .template-card__title,
.template-card-link:focus-visible .template-card__title {
  color: var(--color-link-hover);
}

.template-card__meta {
  margin: var(--space-0);
  color: var(--color-text-muted);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  line-height: var(--line-height-tight);
  letter-spacing: var(--letter-spacing-wide);
  text-transform: uppercase;
}

.template-card__title {
  margin: var(--space-0);
  color: var(--color-text-primary);
  font-size: var(--font-size-lg);
  line-height: var(--line-height-snug);
}

.template-illustration {
  --layout-container-max: var(--container-sm);

  margin-block: var(--space-0);
}

.template-illustration svg {
  display: block;
  inline-size: 100%;
  height: auto;
}

.worked-example__caption {
  margin: var(--space-0);
  color: var(--color-text-brand);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-bold);
  line-height: var(--line-height-tight);
}

.worked-example__tree {
  margin: var(--space-0);
}

.worked-example__tree svg {
  display: block;
  inline-size: 100%;
  height: auto;
}

.template-terminal {
  overflow-x: auto;
  margin: var(--space-0);
  padding: var(--space-5);
  border: var(--space-px) solid var(--color-border);
  border-radius: var(--radius-lg);
  color: var(--color-text-secondary);
  background: var(--color-bg-page);
  font-family: var(--font-family-mono);
  font-size: var(--font-size-sm);
  line-height: var(--line-height-relaxed);
}

.template-terminal__code {
  display: grid;
  gap: var(--space-1);
  min-inline-size: max-content;
  color: inherit;
  font: inherit;
}

.template-terminal__line {
  display: block;
  white-space: nowrap;
}

.template-terminal__line--prompt {
  color: var(--color-text-primary);
  font-weight: var(--font-weight-semibold);
}

.template-terminal__line--output {
  color: var(--color-text-secondary);
}

.template-placeholder {
  display: flex;
  flex-direction: column;
  justify-content: center;
  gap: var(--space-4);
  min-block-size: var(--space-40);
  padding: var(--space-6);
  border: var(--space-px) solid var(--color-border-strong);
  border-radius: var(--radius-xl);
  color: var(--color-text-secondary);
  background: var(--color-bg-surface);
}

.template-placeholder--media {
  min-block-size: calc(var(--space-40) + var(--space-20));
}

.template-placeholder--steps {
  min-block-size: var(--space-40);
}

.template-placeholder__label {
  color: var(--color-text-primary);
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  line-height: var(--line-height-tight);
}

.template-placeholder__line {
  inline-size: 100%;
  block-size: var(--space-3);
  border-radius: var(--radius-full);
  background: var(--color-bg-subtle);
}

.template-placeholder__line--short {
  inline-size: calc(100% - var(--space-16));
}

.home-hero {
  background: var(--color-bg-brand-subtle);
}

.home-hero__inner {
  align-items: center;
}

.home-hero__visual {
  inline-size: 100%;
}

.template-docs-layout {
  align-items: start;
}

.template-sidebar {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  padding: var(--card-padding);
  border: var(--space-px) solid var(--card-border);
  border-radius: var(--card-radius);
  background: var(--card-bg);
}

.template-sidebar__title {
  margin: var(--space-0);
  color: var(--color-text-primary);
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  line-height: var(--line-height-tight);
}

.template-sidebar__links {
  display: grid;
  gap: var(--space-2);
  margin: var(--space-0);
  padding: var(--space-0);
  list-style: none;
}

.template-sidebar__links a {
  display: block;
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-md);
  color: var(--color-text-secondary);
  font-size: var(--font-size-sm);
  text-decoration: none;
}

.template-sidebar__links a:hover {
  color: var(--color-link-hover);
  background: var(--color-bg-subtle);
}

.template-docs-content,
.template-article {
  display: flex;
  flex-direction: column;
  gap: var(--layout-gap-lg);
}

.template-content-section {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  padding-block-end: var(--layout-gap-lg);
  border-block-end: var(--space-px) solid var(--color-border);
}

.template-content-section:last-child {
  padding-block-end: var(--space-0);
  border-block-end: var(--space-0);
}

.template-prose {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  max-inline-size: var(--container-md);
}

.template-prose h2,
.template-prose h3,
.template-prose p,
.template-prose ul,
.template-prose ol {
  margin: var(--space-0);
}

.template-prose h2 {
  color: var(--color-text-primary);
  font-size: var(--font-size-2xl);
  line-height: var(--line-height-tight);
}

.template-prose h3 {
  color: var(--color-text-primary);
  font-size: var(--font-size-xl);
  line-height: var(--line-height-snug);
}

.template-prose p,
.template-prose li {
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
}

.template-prose__related {
  padding-block-start: var(--space-4);
  border-block-start: var(--space-px) solid var(--color-border);
  color: var(--color-text-secondary);
  overflow-wrap: anywhere;
}

.template-prose ul,
.template-prose ol {
  display: grid;
  gap: var(--space-2);
  padding-inline-start: var(--space-6);
}

.template-callout {
  max-inline-size: var(--container-md);
  padding: var(--card-padding);
  border: var(--space-px) solid var(--color-border-strong);
  border-radius: var(--card-radius);
  background: var(--color-bg-brand-subtle);
}

.template-callout p {
  margin: var(--space-0);
  color: var(--color-text-secondary);
}

.template-article-header {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  max-inline-size: var(--container-md);
}

.template-article__hero {
  max-inline-size: var(--container-md);
  margin: var(--space-0);
  color: var(--color-text-primary);
}

.vignette-svg {
  display: block;
  color: var(--color-text-primary);
  width: 100%;
  height: auto;
}

.template-article__inner {
  display: flex;
  flex-direction: column;
  gap: var(--layout-gap-lg);
}

.template-article-meta {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  margin: var(--space-0);
  padding: var(--space-0);
  list-style: none;
}

.template-article-meta li {
  padding: var(--space-1) var(--space-3);
  border: var(--space-px) solid var(--color-border);
  border-radius: var(--radius-full);
  color: var(--color-text-muted);
  background: var(--color-bg-surface);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  line-height: var(--line-height-tight);
}

.template-related {
  display: grid;
  gap: var(--space-4);
  max-inline-size: var(--container-md);
  padding-block-start: var(--layout-gap);
  border-block-start: var(--space-px) solid var(--color-border);
}

.template-related__title {
  margin: var(--space-0);
  color: var(--color-text-primary);
  font-size: var(--font-size-lg);
  line-height: var(--line-height-snug);
}

@media (min-width: 48rem) {
  .worked-example__state {
    grid-template-columns: repeat(2, minmax(0, 1fr));
  }
}

@media (min-width: 40rem) {
  .template-title--display {
    font-size: var(--font-size-4xl);
  }

  .template-card {
    min-block-size: var(--space-40);
  }
}

@media (min-width: 64rem) {
  .template-title--display {
    font-size: var(--font-size-5xl);
  }

  .template-docs-layout {
    grid-template-columns: minmax(0, 1fr) minmax(0, 3fr);
  }

  .template-sidebar {
    position: sticky;
    inset-block-start: calc(var(--nav-height) + var(--layout-gap));
  }
}