docyard 0.1.0 → 0.3.0

data/lib/docyard/templates/assets/css/components/icon.css

@@ -0,0 +1,16 @@
+/* Icon System */
+.docyard-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  width: 1em;
+  height: 1em;
+  line-height: 1;
+}
+
+.docyard-icon svg {
+  width: 100%;
+  height: 100%;
+  display: block;
+}

data/lib/docyard/templates/assets/css/components/logo.css

@@ -0,0 +1,44 @@
+/* Site Logo */
+.site-logo-container {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  position: relative;
+  margin-right: 0.1rem;
+}
+
+.site-logo {
+  height: 2rem;
+  width: auto;
+  display: block;
+  object-fit: contain;
+}
+
+.site-logo-light {
+  display: block;
+}
+
+.site-logo-dark {
+  display: none;
+}
+
+.dark .site-logo-light {
+  display: none;
+}
+
+.dark .site-logo-dark {
+  display: block;
+}
+
+
+@media (max-width: 1024px) {
+  .site-logo {
+    height: 1.75rem;
+  }
+}
+
+@media (max-width: 640px) {
+  .site-logo {
+    height: 1.5rem;
+  }
+}

data/lib/docyard/templates/assets/css/components/navigation.css

@@ -0,0 +1,258 @@
+/* Navigation Components */
+
+/* Sidebar navigation */
+.sidebar nav {
+  flex: 1;
+  overflow-y: auto;
+}
+
+/* Section headers */
+.nav-section {
+  margin-bottom: 0;
+  padding-bottom: var(--space-5);
+}
+
+.nav-section:last-child {
+  padding-bottom: 0;
+}
+
+.nav-section:first-child {
+  margin-top: 0;
+}
+
+.nav-section-title {
+  font-size: 0.6875rem;
+  font-weight: var(--font-weight-semibold);
+  color: var(--color-text-tertiary);
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  padding: 0 var(--space-3);
+  margin-bottom: var(--space-3);
+  margin-top: 0;
+  pointer-events: none;
+  user-select: none;
+}
+
+.nav-section:not(:first-child) {
+  margin-top: var(--space-3);
+  padding-top: 0;
+}
+
+.nav-section:not(:first-child) .nav-section-title {
+  margin-top: 0;
+}
+
+.sidebar nav ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.sidebar nav li {
+  margin: 0;
+}
+
+.sidebar nav a {
+  display: block;
+  padding: 0.5rem var(--space-3);
+  font-size: 0.875rem;
+  color: var(--color-text-secondary);
+  text-decoration: none;
+  border-radius: var(--radius-md);
+  transition: all var(--transition-fast);
+  line-height: 1.4;
+  font-weight: var(--font-weight-medium);
+}
+
+.sidebar nav a:hover {
+  color: var(--color-text);
+  text-decoration: none;
+}
+
+.sidebar nav a.active {
+  color: var(--color-primary);
+  font-weight: var(--font-weight-semibold);
+}
+
+/* Nested navigation */
+.sidebar nav ul ul {
+  margin-left: var(--space-3);
+  margin-top: 0.125rem;
+  margin-bottom: 0.125rem;
+  padding-left: var(--space-4);
+  position: relative;
+}
+
+.sidebar nav ul ul::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 0;
+  bottom: 0;
+  width: 1px;
+  background-color: rgba(148, 163, 184, 0.24);
+}
+
+.sidebar nav ul ul li {
+  position: relative;
+}
+
+.sidebar nav ul ul li:has(> a.active)::before {
+  content: '';
+  position: absolute;
+  left: calc(-1 * var(--space-4));
+  top: 0;
+  bottom: 0;
+  width: 2px;
+  background-color: var(--color-primary);
+  z-index: 1;
+}
+
+.sidebar nav ul ul a {
+  font-size: 0.8125rem;
+  padding: 0.375rem var(--space-3);
+  color: var(--color-text-secondary);
+  line-height: 1.5;
+  font-weight: var(--font-weight-normal);
+  position: relative;
+}
+
+.sidebar nav ul ul a:hover {
+  color: var(--color-text);
+  background-color: transparent;
+}
+
+.sidebar nav ul ul a.active {
+  color: var(--color-primary);
+  background-color: transparent;
+  font-weight: var(--font-weight-semibold);
+}
+
+/* Top level nav items spacing */
+.sidebar nav>ul>li {
+  margin-bottom: 0.125rem;
+}
+
+.sidebar nav ul li {
+  margin-bottom: 0;
+}
+
+/* Collapsible/Accordion items */
+.nav-group-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 0.5rem var(--space-3);
+  font-size: 0.875rem;
+  color: var(--color-text-secondary);
+  text-decoration: none;
+  border-radius: var(--radius-md);
+  transition: all var(--transition-fast);
+  line-height: 1.4;
+  font-weight: var(--font-weight-medium);
+  background: none;
+  border: none;
+  text-align: left;
+  cursor: pointer;
+}
+
+.nav-group-toggle:hover {
+  color: var(--color-text);
+}
+
+.nav-group-toggle:focus-visible {
+  outline: 0.125rem solid var(--color-primary);
+  outline-offset: 0.125rem;
+}
+
+.nav-group-icon {
+  width: 1rem;
+  height: 1rem;
+  color: var(--color-text-tertiary);
+  transition: transform var(--transition-fast);
+  flex-shrink: 0;
+}
+
+.nav-group-toggle[aria-expanded="true"] .nav-group-icon {
+  transform: rotate(90deg);
+}
+
+.nav-group-children {
+  overflow: hidden;
+  transition: max-height var(--transition-base);
+}
+
+.nav-group-children.collapsed {
+  max-height: 0;
+}
+
+/* Mobile menu toggle button */
+.mobile-menu-toggle {
+  display: none;
+  background: transparent;
+  border: none;
+  padding: var(--space-2);
+  cursor: pointer;
+  width: 2.25rem;
+  height: 2.25rem;
+  align-items: center;
+  justify-content: center;
+  border-radius: var(--radius-md);
+  transition: background-color var(--transition-fast);
+}
+
+.mobile-menu-toggle:hover {
+  background: var(--color-bg-secondary);
+}
+
+@media (max-width: 768px) {
+  .mobile-menu-toggle {
+    display: flex;
+  }
+}
+
+/* Sidebar footer */
+.sidebar-footer {
+  margin-top: auto;
+  padding: var(--space-3) var(--space-5) var(--space-5);
+}
+
+.sidebar-footer-link {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  text-decoration: none;
+  padding: var(--space-2);
+  border-radius: var(--radius-md);
+  transition: all var(--transition-fast);
+}
+
+.sidebar-footer-link:hover {
+  text-decoration: none;
+}
+
+.sidebar-footer-link:hover .external-icon {
+  opacity: 0.5;
+}
+
+.sidebar-footer-text {
+  flex: 1;
+}
+
+.sidebar-footer-title {
+  margin: 0;
+  font-size: 0.6875rem;
+  color: var(--color-text-tertiary);
+  font-weight: var(--font-weight-medium);
+  line-height: 1.4;
+}
+
+.external-icon {
+  width: 0.75rem;
+  height: 0.75rem;
+  color: var(--color-text-secondary);
+  opacity: 0;
+  transition: opacity var(--transition-fast);
+  flex-shrink: 0;
+}

data/lib/docyard/templates/assets/css/components/tabs.css

@@ -0,0 +1,298 @@
+/* Tabs Component - Modern Design */
+
+.docyard-tabs {
+  margin: var(--space-6) 0;
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+  background: var(--color-bg);
+  border: 1px solid var(--color-border);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04);
+}
+
+.dark .docyard-tabs {
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+}
+
+/* Tab List Wrapper - Contains scroll indicators */
+.docyard-tabs__list-wrapper {
+  position: relative;
+  background: var(--color-bg-secondary);
+}
+
+/* Tab List Container */
+.docyard-tabs__list {
+  display: flex;
+  gap: var(--space-2);
+  padding: 0 var(--space-4);
+  background: transparent;
+  position: relative;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+  scrollbar-width: none;
+  margin: 0;
+}
+
+.docyard-tabs__list::-webkit-scrollbar {
+  display: none;
+}
+
+/* Bottom border line - sits behind tabs */
+.docyard-tabs__list::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 2px;
+  background: var(--color-border);
+  z-index: 0;
+}
+
+/* Individual Tab Button */
+.docyard-tabs__tab {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: var(--space-4) var(--space-4);
+  background: transparent;
+  border: none;
+  border-radius: 0;
+  font-size: var(--font-size-sm);
+  font-weight: var(--font-weight-semibold);
+  font-family: var(--font-sans);
+  color: var(--color-text-secondary);
+  cursor: pointer;
+  transition: all 0.2s ease;
+  position: relative;
+  white-space: nowrap;
+  flex-shrink: 0;
+  line-height: 1.5;
+  z-index: 1;
+}
+
+.docyard-tabs__tab:hover {
+  color: var(--color-primary);
+  background: rgba(0, 0, 0, 0.02);
+}
+
+.dark .docyard-tabs__tab:hover {
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.docyard-tabs__tab[aria-selected="true"] {
+  color: var(--color-primary);
+  background: var(--color-bg);
+}
+
+/* Cover the border-bottom for active tab */
+.docyard-tabs__tab[aria-selected="true"]::after {
+  content: '';
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 2px;
+  background: var(--color-bg);
+  z-index: 2;
+}
+
+/* Focus indicator for keyboard navigation */
+.docyard-tabs__tab:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+  z-index: 1;
+}
+
+/* Tab Icon Container */
+.docyard-tabs__icon {
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+
+.docyard-tabs__icon .docyard-icon {
+  width: 1rem;
+  height: 1rem;
+  display: inline-flex;
+}
+
+.docyard-tabs__icon .docyard-icon svg {
+  width: 100%;
+  height: 100%;
+}
+
+/* Scroll Indicators - Gradient overlays showing more content */
+.docyard-tabs__scroll-indicator {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 3rem;
+  pointer-events: none;
+  z-index: 2;
+  opacity: 0;
+  transition: opacity var(--transition-base);
+}
+
+.docyard-tabs__scroll-indicator--left {
+  left: 0;
+  background: linear-gradient(to right,
+      var(--color-bg-secondary),
+      transparent);
+}
+
+.docyard-tabs__scroll-indicator--right {
+  right: 0;
+  background: linear-gradient(to left,
+      var(--color-bg-secondary),
+      transparent);
+}
+
+.docyard-tabs__scroll-indicator.is-visible {
+  opacity: 1;
+}
+
+/* Slide indicator - vibrant accent line */
+.docyard-tabs__indicator {
+  position: absolute;
+  top: 0;
+  left: 0;
+  height: 2px;
+  background: var(--color-primary);
+  transition: transform 0.25s cubic-bezier(0.4, 0, 0.2, 1),
+    width 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+  will-change: transform, width;
+  pointer-events: none;
+  z-index: 3;
+}
+
+/* Tab Panel Container */
+.docyard-tabs__panel {
+  padding: 0;
+  display: none;
+  outline: none;
+  background: var(--color-bg);
+}
+
+/* If panel has mixed content (not just code block), add padding to panel */
+.docyard-tabs__panel:not(:has(> [class*="language-"]:only-child)) {
+  padding: var(--space-6);
+}
+
+.docyard-tabs__panel p {
+  margin-bottom: 0;
+}
+
+.docyard-tabs__panel[aria-hidden="false"] {
+  display: block;
+}
+
+/* Ensure proper spacing for content inside panels */
+.docyard-tabs__panel>*:first-child {
+  margin-top: 0;
+}
+
+.docyard-tabs__panel>*:last-child {
+  margin-bottom: 0;
+}
+
+/* Code blocks inside tabs - seamless integration */
+.docyard-tabs__panel .highlight,
+.docyard-tabs__panel pre {
+  margin: 0;
+  border-radius: 0;
+  border: none;
+  padding: 0 !important;
+  background-color: var(--color-bg) !important;
+  box-shadow: none !important;
+}
+
+/* If panel has ONLY code block, add padding to the highlight element */
+.docyard-tabs__panel:has(> [class*="language-"]:only-child) pre {
+  padding: var(--space-6) !important;
+}
+
+/* Apply secondary background when highlighter-rouge has siblings */
+.docyard-tabs__panel .highlighter-rouge:not(:only-child) .highlight pre code {
+  padding: var(--space-4) !important;
+  background-color: var(--color-bg-secondary) !important;
+  border-radius: var(--radius-lg) !important;
+  border: 1px solid var(--color-border) !important;
+  box-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.03) !important;
+}
+
+.docyard-tabs__panel pre code {
+  padding: 0 !important;
+  display: block;
+  overflow-x: auto;
+  background-color: var(--color-bg) !important;
+  border-radius: 0;
+  border: none !important;
+  box-shadow: none !important;
+}
+
+.docyard-tabs__panel pre code .w {
+  background-color: var(--color-bg) !important;
+}
+
+/* Inline code inside tabs */
+.docyard-tabs__panel :not(pre)>code {
+  background-color: var(--color-code-bg);
+  padding: 0.125rem 0.375rem;
+  border-radius: var(--radius-sm);
+  font-size: 0.9em;
+}
+
+/* Mobile responsive - preserve design language */
+@media (max-width: 640px) {
+  .docyard-tabs {
+    margin: var(--space-4) 0;
+  }
+
+  .docyard-tabs__list {
+    padding: 0 var(--space-3);
+    gap: var(--space-1);
+  }
+
+  .docyard-tabs__tab {
+    padding: var(--space-3) var(--space-3);
+    font-size: var(--font-size-sm);
+    gap: var(--space-1-5);
+  }
+
+  .docyard-tabs__icon .docyard-icon {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+
+  .docyard-tabs__panel {
+    padding: var(--space-4);
+  }
+
+  .docyard-tabs__panel pre code {
+    font-size: var(--font-size-sm);
+  }
+
+  .docyard-tabs__panel .highlighter-rouge:not(:only-child) .highlight pre code {
+    padding: var(--space-3) !important;
+    font-size: var(--font-size-sm);
+  }
+}
+
+/* Reduced motion support */
+@media (prefers-reduced-motion: reduce) {
+  .docyard-tabs__tab {
+    transition: none;
+  }
+}
+
+/* High contrast mode support */
+@media (prefers-contrast: high) {
+  .docyard-tabs {
+    box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.2);
+  }
+
+  .docyard-tabs__tab[aria-selected="true"] {
+    outline: 2px solid var(--color-primary);
+    outline-offset: -2px;
+  }
+}

data/lib/docyard/templates/assets/css/components/theme-toggle.css

@@ -0,0 +1,61 @@
+/* Theme Toggle */
+.theme-toggle {
+  padding: 0;
+  margin-left: var(--space-4);
+  background: none;
+  border: none;
+  cursor: pointer;
+  position: relative;
+}
+
+.theme-toggle-track {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  position: relative;
+  width: 3.25rem;
+  height: 1.75rem;
+  padding: 0 0.375rem;
+  border-radius: 0.875rem;
+  background-color: var(--color-border);
+  border: 1px solid var(--color-border);
+  transition: background-color 0.25s ease;
+}
+
+.theme-toggle:hover .theme-toggle-track {
+  background-color: var(--color-border-secondary);
+}
+
+.theme-toggle-icon {
+  position: relative;
+  z-index: 1;
+  flex-shrink: 0;
+}
+
+.theme-toggle-sun-icon {
+  color: var(--color-warning);
+}
+
+.theme-toggle-moon-icon {
+  color: var(--color-text-tertiary);
+}
+
+.dark .theme-toggle-moon-icon {
+  color: var(--color-primary);
+}
+
+.theme-toggle-thumb {
+  position: absolute;
+  top: 0.125rem;
+  left: 0.125rem;
+  width: 1.375rem;
+  height: 1.375rem;
+  background-color: var(--color-bg);
+  border-radius: 50%;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.2);
+  transition: transform 0.25s ease;
+}
+
+.dark .theme-toggle-thumb {
+  transform: translateX(1.5rem);
+}