docyard 0.6.0 → 0.8.0

data/lib/docyard/templates/assets/css/layout.css

@@ -1,24 +1,41 @@
-/* Page Layout */
+html {
+  scroll-padding-top: calc(var(--header-height) + var(--spacing-6));
+}
+
+html:has(.has-tabs) {
+  scroll-padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--spacing-6));
+}
+
+@media (max-width: 1280px) and (min-width: 1025px) {
+  html {
+    scroll-padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--spacing-6));
+  }
+}
+
+@media (max-width: 1024px) {
+  html {
+    scroll-padding-top: calc(var(--header-height) + var(--tab-bar-height) + var(--spacing-6));
+  }
+}
+
+.page-wrapper {
+  max-width: var(--layout-max-width);
+  margin: 0 auto;
+  position: relative;
+}
 
-/* Header */
 .header {
   position: fixed;
   top: 0;
   left: 0;
   right: 0;
   height: var(--header-height);
-  background-color: var(--color-bg);
+  background-color: oklch(from var(--background) l c h / 80%);
   backdrop-filter: blur(12px);
-  border-bottom: 1px solid var(--color-border);
-  box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.02);
   z-index: var(--z-header);
   transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
-.dark .header {
-  box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.3);
-}
-
 .header.hide-on-scroll {
   transform: translateY(-100%);
 }
@@ -26,33 +43,51 @@
 .header-content {
   display: flex;
   align-items: center;
-  justify-content: space-between;
   height: 100%;
-  padding: var(--space-5) var(--space-6);
+  max-width: var(--layout-max-width);
+  margin: 0 auto;
+  padding: var(--spacing-5) var(--spacing-6);
+  border-bottom: 1px solid var(--hr-color);
+}
+
+.header-logo {
+  flex-shrink: 0;
+}
+
+.header-center {
+  flex: 1;
+  display: flex;
+  justify-content: center;
+  padding: 0 var(--spacing-6);
+}
+
+.header-actions {
+  flex-shrink: 0;
+  margin-left: auto;
 }
 
 .header-left {
   display: flex;
   align-items: center;
-  gap: var(--space-4);
+  gap: var(--spacing-4);
 }
 
 .header-logo {
   display: flex;
   align-items: center;
   text-decoration: none;
-  gap: var(--space-3);
+  gap: var(--spacing-3);
 }
 
 .header-title {
   font-size: 1.0625rem;
-  font-weight: var(--font-weight-semibold);
-  color: var(--color-text);
+  font-weight: var(--font-semibold);
+  color: var(--foreground);
   letter-spacing: -0.02em;
 }
 
 .header-logo:hover .header-title {
-  color: var(--color-primary);
+  color: var(--primary);
 }
 
 .header-logo:hover {
@@ -60,17 +95,94 @@
 }
 
 .header-logo:focus-visible {
-  outline: 2px solid var(--color-primary);
-  outline-offset: 4px;
-  border-radius: var(--radius-sm);
+  outline: none;
+  border-radius: var(--radius-lg);
+  box-shadow: 0 0 0 var(--ring-width) oklch(from var(--ring) l c h / 50%);
 }
 
-/* Secondary Header (Tablet & Mobile Navigation Bar) */
+.header-ctas {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-3);
+}
+
+.header-cta {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-1-5);
+  padding: 6px 12px;
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  text-decoration: none;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: background-color 0.2s ease, border-color 0.2s ease;
+  white-space: nowrap;
+  border: 1px solid transparent;
+}
+
+.header-cta:hover {
+  text-decoration: none;
+}
+
+.header-cta--primary {
+  background-color: var(--primary);
+  color: var(--primary-foreground);
+  border-color: var(--primary);
+}
+
+.header-cta--primary:hover {
+  background-color: oklch(from var(--primary) calc(l - 0.05) c h);
+  border-color: oklch(from var(--primary) calc(l - 0.05) c h);
+  color: var(--primary-foreground);
+}
+
+.header-cta--primary:active {
+  background-color: oklch(from var(--primary) calc(l - 0.08) c h);
+  border-color: oklch(from var(--primary) calc(l - 0.08) c h);
+}
+
+.header-cta--secondary {
+  background: transparent;
+  color: var(--foreground);
+  border-color: var(--border);
+}
+
+.header-cta--secondary:hover {
+  background: var(--muted);
+  color: var(--foreground);
+}
+
+.header-cta--secondary:active {
+  opacity: 0.8;
+}
+
+.header-cta-arrow {
+  width: 16px;
+  height: 16px;
+  stroke-width: 2;
+  transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
+}
+
+.header-cta--primary:hover .header-cta-arrow {
+  transform: translateX(3px);
+}
+
+@media (max-width: 1024px) {
+  .header-ctas {
+    display: none;
+  }
+}
+
+.sidebar-ctas {
+  display: none;
+}
+
+
 .secondary-header {
   display: none;
 }
 
-/* Tablet: Show secondary header with TOC toggle only */
 @media (max-width: 1280px) and (min-width: 1025px) {
   .secondary-header {
     display: flex;
@@ -78,13 +190,13 @@
     justify-content: flex-end;
     position: fixed;
     top: var(--header-height);
-    left: var(--sidebar-width);
-    right: 0;
+    left: calc(max(0px, (100vw - var(--layout-max-width)) / 2) + var(--sidebar-width));
+    right: max(0px, calc((100vw - var(--layout-max-width)) / 2));
     height: 3rem;
     min-height: 3rem;
-    background: var(--color-bg);
-    border-bottom: 1px solid var(--color-border);
-    padding: 0 var(--space-6);
+    background: var(--background);
+    border-bottom: 1px solid var(--border);
+    padding: 0 var(--spacing-6);
     z-index: var(--z-secondary-header);
     transition: top 0.3s cubic-bezier(0.4, 0, 0.2, 1), left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
     box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.02);
@@ -103,7 +215,6 @@
   }
 }
 
-/* Mobile: Show menu button + TOC toggle */
 @media (max-width: 1024px) {
   .secondary-header {
     display: flex;
@@ -115,9 +226,9 @@
     right: 0;
     height: 3rem;
     min-height: 3rem;
-    background: var(--color-bg);
-    border-bottom: 1px solid var(--color-border);
-    padding: 0 var(--space-6);
+    background: var(--background);
+    border-bottom: 1px solid var(--border);
+    padding: 0 var(--spacing-6);
     z-index: var(--z-secondary-header);
     transition: top 0.3s cubic-bezier(0.4, 0, 0.2, 1);
     box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.02);
@@ -130,33 +241,33 @@
   .secondary-header-menu {
     display: flex;
     align-items: center;
-    gap: var(--space-2);
+    gap: var(--spacing-2);
     background: none;
     border: none;
-    padding: var(--space-2);
-    font-size: var(--font-size-sm);
-    font-weight: var(--font-weight-medium);
-    color: var(--color-text);
+    padding: var(--spacing-2);
+    font-size: var(--text-sm);
+    font-weight: var(--font-medium);
+    color: var(--foreground);
     cursor: pointer;
     border-radius: var(--radius-md);
     transition: background-color 0.2s ease;
     font-family: var(--font-sans);
-    margin-left: calc(-1 * var(--space-2));
+    margin-left: calc(-1 * var(--spacing-2));
     outline: none;
   }
 
   .secondary-header-menu:hover {
-    background-color: var(--color-bg-tertiary);
+    background-color: var(--muted);
   }
 
   .secondary-header-menu:active {
-    background-color: var(--color-border);
+    background-color: var(--muted);
   }
 
   .secondary-header-menu:focus-visible {
-    outline: 2px solid var(--color-primary);
-    outline-offset: 2px;
-    border-radius: var(--radius-sm);
+    outline: none;
+    border-radius: var(--radius-lg);
+    box-shadow: 0 0 0 var(--ring-width) oklch(from var(--ring) l c h / 50%);
   }
 
   .secondary-header-menu .icon {
@@ -164,57 +275,77 @@
   }
 }
 
-/* Main layout container */
 .layout {
   display: flex;
   min-height: calc(100vh - var(--header-height));
   padding-top: var(--header-height);
   width: 100%;
-  max-width: 100vw;
-  overflow-x: hidden;
+  max-width: var(--layout-max-width);
+  margin: 0 auto;
+  position: relative;
 }
 
-/* Sidebar */
 .sidebar {
   width: var(--sidebar-width);
   height: calc(100vh - var(--header-height));
   position: fixed;
   top: var(--header-height);
-  left: 0;
-  background-color: var(--color-sidebar-bg);
-  border-right: 1px solid var(--color-border);
-  overflow-y: auto;
-  overflow-x: hidden;
-  overflow-anchor: none;
+  left: max(0px, calc((100vw - var(--layout-max-width)) / 2));
+  background-color: var(--sidebar);
   z-index: var(--z-sidebar);
   display: flex;
   flex-direction: column;
 }
 
-.sidebar > nav {
-  padding: var(--space-5) var(--space-5);
+.sidebar-scroll {
+  flex: 1;
+  overflow-y: auto;
+  overflow-x: hidden;
+  overflow-anchor: none;
   overscroll-behavior: contain;
+  position: relative;
 }
 
-/* Sidebar scrollbar styling */
-.sidebar::-webkit-scrollbar {
-  width: 0.5rem;
+.sidebar-scroll>nav {
+  padding: var(--spacing-4) var(--spacing-4);
 }
 
-.sidebar::-webkit-scrollbar-track {
-  background: transparent;
+.sidebar::before,
+.sidebar::after {
+  content: '';
+  position: absolute;
+  left: 0;
+  right: 0;
+  height: 2rem;
+  pointer-events: none;
+  z-index: 1;
+  opacity: 0;
+  transition: opacity 0.2s ease;
 }
 
-.sidebar::-webkit-scrollbar-thumb {
-  background: rgba(208, 215, 222, 0.5);
-  border-radius: 0.25rem;
+.sidebar::before {
+  top: 0;
+  background: linear-gradient(to bottom, var(--sidebar) 0%, transparent 100%);
 }
 
-.sidebar::-webkit-scrollbar-thumb:hover {
-  background: rgba(208, 215, 222, 0.7);
+.sidebar::after {
+  bottom: 0;
+  background: linear-gradient(to top, var(--sidebar) 0%, transparent 100%);
+}
+
+.sidebar.can-scroll-top::before {
+  opacity: 1;
+}
+
+.sidebar.can-scroll-bottom::after {
+  opacity: 1;
+}
+
+.sidebar-scroll {
+  scrollbar-width: thin;
+  scrollbar-color: var(--border) transparent;
 }
 
-/* Main content area */
 .layout-main {
   flex: 1;
   margin-left: var(--sidebar-width);
@@ -222,30 +353,71 @@
   display: flex;
   flex-direction: column;
   min-width: 0;
+  transition: margin-left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+@media (min-width: 1025px) {
+  .sidebar-collapsed .sidebar {
+    transform: translateX(-100%);
+    opacity: 0;
+    pointer-events: none;
+  }
+
+  .sidebar-collapsed .layout-main {
+    margin-left: 0;
+  }
+
+  .sidebar-collapsed main.content {
+    max-width: 100%;
+  }
+
+  .sidebar-collapsed .secondary-header {
+    left: max(0px, calc((100vw - var(--layout-max-width)) / 2));
+  }
+
+  .sidebar {
+    transition:
+      transform 0.3s cubic-bezier(0.4, 0, 0.2, 1),
+      opacity 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+
+  main.content {
+    transition: margin 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  }
 }
 
-/* Tablet Layout (1024px - 1280px) */
 @media (max-width: 1280px) and (min-width: 1025px) {
   .layout-main {
     margin-right: 0;
   }
 }
 
-/* Content wrapper */
 main.content {
   flex: 1;
   max-width: var(--content-max-width);
   width: 100%;
-  padding: var(--space-16) var(--space-10);
+  padding: var(--spacing-8) var(--spacing-10) var(--spacing-16);
   margin: 0 auto;
   min-width: 0;
   box-sizing: border-box;
 }
 
-/* Mobile Layout */
 @media (max-width: 1024px) {
   .header-content {
-    padding: var(--space-4) var(--space-6);
+    padding: var(--spacing-4) var(--spacing-6);
+  }
+
+  .header-center {
+    flex: 0;
+    padding: 0;
+    margin-left: auto;
+  }
+
+  .header-actions {
+    display: flex;
+    align-items: center;
+    gap: var(--spacing-1);
+    margin-left: 0;
   }
 
   .layout {
@@ -257,16 +429,17 @@ main.content {
     position: fixed;
     top: 0;
     left: 0;
-    bottom: 0;
-    right: auto;
     width: 20rem;
     max-width: 85vw;
     height: 100vh;
+    height: 100dvh;
     transform: translateX(-100%);
     transition: transform 0.25s cubic-bezier(0.4, 0, 0.2, 1);
     z-index: var(--z-sidebar);
-    background-color: var(--color-sidebar-bg);
+    background-color: var(--sidebar);
     box-shadow: none;
+    padding-top: env(safe-area-inset-top, 0);
+    padding-bottom: env(safe-area-inset-bottom, 0);
   }
 
   .sidebar.is-open {
@@ -285,11 +458,10 @@ main.content {
   }
 
   main.content {
-    padding: var(--space-6);
+    padding: var(--spacing-6);
   }
 }
 
-/* Mobile menu overlay */
 @media (max-width: 1024px) {
   .mobile-overlay {
     position: fixed;
@@ -297,7 +469,8 @@ main.content {
     left: 0;
     right: 0;
     bottom: 0;
-    background-color: rgba(0, 0, 0, 0.5);
+    background-color: var(--overlay-bg);
+    backdrop-filter: blur(var(--overlay-blur));
     z-index: var(--z-overlay);
     opacity: 0;
     pointer-events: none;
@@ -310,31 +483,274 @@ main.content {
   }
 }
 
-/* Skip to main content link (accessibility) */
 .skip-link {
-  position: absolute;
-  top: -40px;
-  left: 0;
-  background: var(--color-primary);
-  color: white;
-  padding: var(--space-2) var(--space-4);
+  position: fixed;
+  left: 50%;
+  top: var(--spacing-3);
+  background: var(--foreground);
+  color: var(--background);
+  font-size: var(--text-sm);
+  font-weight: var(--font-medium);
+  padding: var(--spacing-2) var(--spacing-4);
   text-decoration: none;
-  z-index: 100;
+  z-index: 9999;
+  border-radius: var(--radius-4xl);
+  box-shadow: var(--shadow-xl);
+  transform: translate(-50%, -200%);
+  transition: transform var(--transition-base);
 }
 
 .skip-link:focus {
-  top: 0;
+  transform: translate(-50%, 0);
+  outline: none;
 }
 
-/* Container utilities */
 .container {
   max-width: var(--layout-max-width);
   margin: 0 auto;
-  padding: 0 var(--space-6);
+  padding: 0 var(--spacing-6);
 }
 
 .container-narrow {
   max-width: var(--content-max-width);
   margin: 0 auto;
-  padding: 0 var(--space-6);
+  padding: 0 var(--spacing-6);
+}
+
+.footer-content {
+  max-width: var(--layout-max-width);
+  margin: 0 auto;
+  padding: var(--spacing-5) var(--spacing-6);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1.5rem;
+  font-size: var(--text-sm);
+}
+
+.footer-content--centered {
+  justify-content: center;
+}
+
+.footer-content--no-attribution .footer-links {
+  margin-right: auto;
+}
+
+.footer-attribution {
+  color: var(--muted-foreground);
+  transition: color 0.15s ease;
+}
+
+.footer-attribution:hover {
+  color: var(--foreground);
+}
+
+.footer-links {
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+}
+
+.footer-links a {
+  color: var(--muted-foreground);
+  transition: color 0.15s ease;
+}
+
+.footer-links a:hover {
+  color: var(--foreground);
+}
+
+.footer-socials {
+  display: flex;
+  align-items: center;
+  gap: 0;
+}
+
+.footer-socials a {
+  color: var(--muted-foreground);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.25rem;
+  height: 2.25rem;
+  border-radius: var(--radius-4xl);
+  background: transparent;
+  transition: background-color var(--transition-fast), color var(--transition-fast);
+}
+
+.footer-socials a:hover {
+  color: var(--foreground);
+  background-color: var(--muted);
+}
+
+.dark .footer-socials a:hover {
+  background-color: oklch(from var(--muted) l c h / 50%);
+}
+
+.footer-socials svg {
+  width: 18px;
+  height: 18px;
+}
+
+@media (max-width: 1024px) {
+  .footer-content {
+    flex-direction: column;
+    gap: 1rem;
+    padding: 1.5rem var(--spacing-6);
+  }
+
+  .footer-links {
+    order: 1;
+    flex-wrap: wrap;
+    justify-content: center;
+    gap: 1rem;
+  }
+
+  .footer-socials {
+    order: 2;
+  }
+
+  .footer-attribution {
+    order: 3;
+  }
+
+  .footer-content--no-attribution .footer-links {
+    margin-right: 0;
+  }
+}
+
+.doc-aside {
+  width: var(--toc-width);
+  position: fixed;
+  top: var(--header-height);
+  right: max(0px, calc((100vw - var(--layout-max-width)) / 2));
+  height: calc(100vh - var(--header-height));
+  display: flex;
+  flex-direction: column;
+  background-color: var(--background);
+}
+
+.doc-footer-desktop {
+  flex-shrink: 0;
+  padding: 0 var(--spacing-4) var(--spacing-6);
+}
+
+.doc-aside.has-overflow .doc-footer-desktop {
+  margin-top: auto;
+}
+
+.doc-footer-desktop .site-footer {
+  margin-top: var(--spacing-6);
+  padding-top: var(--spacing-4);
+  border-top: 1px solid var(--border);
+}
+
+.doc-footer-mobile {
+  display: none;
+}
+
+.site-footer__socials {
+  display: flex;
+  align-items: center;
+  gap: 0;
+  margin-bottom: var(--spacing-3);
+}
+
+.site-footer__socials a {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.25rem;
+  height: 2.25rem;
+  color: var(--muted-foreground);
+  border-radius: var(--radius-4xl);
+  background: transparent;
+  transition: background-color var(--transition-fast), color var(--transition-fast);
+}
+
+.site-footer__socials a:hover {
+  color: var(--foreground);
+  background-color: var(--muted);
+}
+
+.dark .site-footer__socials a:hover {
+  background-color: oklch(from var(--muted) l c h / 50%);
+}
+
+.site-footer__socials svg {
+  width: 18px;
+  height: 18px;
+}
+
+.site-footer__credits {
+  font-size: var(--text-xs);
+  color: var(--muted-foreground);
+  line-height: 1.5;
+}
+
+.site-footer__attribution {
+  display: block;
+  color: var(--muted-foreground);
+  text-decoration: none;
+  transition: color var(--transition-fast);
+}
+
+.site-footer__attribution:hover {
+  color: var(--foreground);
+}
+
+.site-footer__copyright {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-1);
+  margin-top: var(--spacing-1);
+  color: oklch(from var(--muted-foreground) l c h / 70%);
+}
+
+.site-footer__copyright svg {
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+}
+
+@media (max-width: 1280px) and (min-width: 1025px) {
+  .doc-aside {
+    display: none;
+  }
+
+  .doc-footer-mobile {
+    display: block;
+    margin-top: var(--spacing-12);
+    text-align: center;
+  }
+
+  .doc-footer-mobile .site-footer__socials {
+    justify-content: center;
+    margin-bottom: var(--spacing-4);
+  }
+
+  .doc-footer-mobile .site-footer__copyright {
+    justify-content: center;
+  }
+}
+
+@media (max-width: 1024px) {
+  .doc-aside {
+    display: none;
+  }
+
+  .doc-footer-mobile {
+    display: block;
+    margin-top: var(--spacing-12);
+    text-align: center;
+  }
+
+  .doc-footer-mobile .site-footer__socials {
+    justify-content: center;
+    margin-bottom: var(--spacing-4);
+  }
+
+  .doc-footer-mobile .site-footer__copyright {
+    justify-content: center;
+  }
 }