docyard 0.2.0 → 0.4.0

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

@@ -0,0 +1,169 @@
+/* Callouts/Admonitions */
+.docyard-callout {
+  display: flex;
+  gap: var(--space-3);
+  padding: var(--space-4);
+  margin: var(--space-6) 0;
+  border: 1px solid;
+  border-radius: var(--radius-lg);
+  transition: border-color var(--transition-base), background-color var(--transition-base);
+}
+
+.docyard-callout__icon {
+  flex-shrink: 0;
+  width: 22px;
+  height: 22px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.docyard-callout__icon .docyard-icon {
+  width: 100%;
+  height: 100%;
+}
+
+.docyard-callout__icon svg {
+  width: 100%;
+  height: 100%;
+}
+
+.docyard-callout__content {
+  flex: 1;
+  min-width: 0;
+}
+
+.docyard-callout__title {
+  font-weight: var(--font-weight-semibold);
+  margin: 0 0 var(--space-2) 0;
+  font-size: var(--font-size-base);
+  line-height: var(--line-height-tight);
+}
+
+.docyard-callout__body {
+  line-height: var(--line-height-relaxed);
+}
+
+.docyard-callout__body>*:first-child {
+  margin-top: 0;
+}
+
+.docyard-callout__body>*:last-child {
+  margin-bottom: 0;
+}
+
+/* Code blocks inside callouts */
+.docyard-callout__body .highlight {
+  margin: var(--space-4) 0;
+  border-radius: var(--radius-md);
+}
+
+.docyard-callout__body pre.highlight {
+  margin: 0;
+}
+
+.docyard-callout__body pre {
+  margin: 0;
+  border-radius: var(--radius-md);
+}
+
+.docyard-callout__body pre code {
+  display: block;
+  padding: var(--space-4);
+  overflow-x: auto;
+  background-color: var(--color-bg-secondary) !important;
+}
+
+.docyard-callout__body :not(pre)>code {
+  background-color: rgba(0, 0, 0, 0.05);
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  padding: 0.125rem 0.375rem;
+  border-radius: var(--radius-sm);
+}
+
+.dark .docyard-callout__body :not(pre)>code {
+  background-color: rgba(255, 255, 255, 0.1);
+  border: 1px solid rgba(255, 255, 255, 0.15);
+}
+
+/* Callout type: note (blue) */
+.docyard-callout--note {
+  border-color: var(--callout-note-border);
+  background-color: var(--callout-note-bg);
+}
+
+.docyard-callout--note .docyard-callout__icon {
+  color: var(--callout-note);
+}
+
+.docyard-callout--note .docyard-callout__title {
+  color: var(--callout-note-text);
+}
+
+/* Callout type: tip (green) */
+.docyard-callout--tip {
+  border-color: var(--callout-tip-border);
+  background-color: var(--callout-tip-bg);
+}
+
+.docyard-callout--tip .docyard-callout__icon {
+  color: var(--callout-tip);
+}
+
+.docyard-callout--tip .docyard-callout__title {
+  color: var(--callout-tip-text);
+}
+
+/* Callout type: important (purple) */
+.docyard-callout--important {
+  border-color: var(--callout-important-border);
+  background-color: var(--callout-important-bg);
+}
+
+.docyard-callout--important .docyard-callout__icon {
+  color: var(--callout-important);
+}
+
+.docyard-callout--important .docyard-callout__title {
+  color: var(--callout-important-text);
+}
+
+/* Callout type: warning (orange/yellow) */
+.docyard-callout--warning {
+  border-color: var(--callout-warning-border);
+  background-color: var(--callout-warning-bg);
+}
+
+.docyard-callout--warning .docyard-callout__icon {
+  color: var(--callout-warning);
+}
+
+.docyard-callout--warning .docyard-callout__title {
+  color: var(--callout-warning-text);
+}
+
+/* Callout type: danger (red) */
+.docyard-callout--danger {
+  border-color: var(--callout-danger-border);
+  background-color: var(--callout-danger-bg);
+}
+
+.docyard-callout--danger .docyard-callout__icon {
+  color: var(--callout-danger);
+}
+
+.docyard-callout--danger .docyard-callout__title {
+  color: var(--callout-danger-text);
+}
+
+/* Nested callouts */
+.docyard-callout .docyard-callout {
+  margin: var(--space-4) 0;
+}
+
+/* Reduced motion support */
+@media (prefers-reduced-motion: reduce) {
+  .docyard-callout {
+    transition: none;
+  }
+}

data/lib/docyard/templates/assets/css/components/code-block.css

@@ -0,0 +1,196 @@
+/* Code Block Component with Copy Button */
+
+.docyard-code-block {
+  position: relative;
+  margin: var(--space-6) 0;
+}
+
+.docyard-code-block .highlight {
+  margin: 0;
+}
+
+/* Inside tabs - remove wrapper margin when code block is only child */
+.docyard-tabs__panel:has(> [class*="language-"]:only-child) .docyard-code-block {
+  margin: 0;
+}
+
+/* Inside tabs with mixed content - use normal spacing */
+.docyard-tabs__panel:not(:has(> [class*="language-"]:only-child)) .docyard-code-block {
+  margin: var(--space-4) 0;
+}
+
+/* Inside callouts - use callout's spacing */
+.docyard-callout__body .docyard-code-block {
+  margin: var(--space-4) 0;
+}
+
+.docyard-callout__body .docyard-code-block:first-child {
+  margin-top: 0;
+}
+
+.docyard-callout__body .docyard-code-block:last-child {
+  margin-bottom: 0;
+}
+
+.docyard-code-block__copy {
+  position: absolute;
+  top: var(--space-3);
+  right: var(--space-3);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  padding: 0;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-md);
+  background-color: var(--color-bg);
+  color: var(--color-text-secondary);
+  cursor: pointer;
+  transition: background-color var(--transition-base), border-color var(--transition-base), color var(--transition-base), opacity var(--transition-base), visibility var(--transition-base);
+  opacity: 0;
+  visibility: hidden;
+}
+
+.docyard-code-block:hover .docyard-code-block__copy {
+  opacity: 1;
+  visibility: visible;
+}
+
+.docyard-code-block__copy:hover {
+  background-color: var(--color-bg-secondary);
+  border-color: var(--color-text-tertiary);
+  color: var(--color-text);
+}
+
+.docyard-code-block__copy:active {
+  transform: scale(0.95);
+}
+
+.docyard-code-block__copy:focus-visible {
+  opacity: 1;
+  visibility: visible;
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+/* Icon sizing */
+.docyard-code-block__copy svg {
+  width: 16px;
+  height: 16px;
+  transition: transform 0.2s ease, opacity 0.2s ease;
+}
+
+/* Success state */
+.docyard-code-block__copy.is-success {
+  opacity: 1;
+  visibility: visible;
+  background-color: var(--color-primary);
+  border-color: var(--color-primary);
+  color: white;
+  animation: success-pulse 0.4s ease;
+}
+
+.docyard-code-block__copy.is-success:hover {
+  background-color: var(--color-primary-hover);
+  border-color: var(--color-primary-hover);
+  color: white;
+}
+
+.docyard-code-block__copy.is-success svg {
+  animation: check-pop 0.3s ease;
+}
+
+/* Success animation */
+@keyframes success-pulse {
+  0% {
+    transform: scale(1);
+  }
+
+  50% {
+    transform: scale(1.1);
+  }
+
+  100% {
+    transform: scale(1);
+  }
+}
+
+@keyframes check-pop {
+  0% {
+    transform: scale(0) rotate(-45deg);
+    opacity: 0;
+  }
+
+  50% {
+    transform: scale(1.2) rotate(10deg);
+  }
+
+  100% {
+    transform: scale(1) rotate(0deg);
+    opacity: 1;
+  }
+}
+
+/* Error state */
+.docyard-code-block__copy.is-error {
+  opacity: 1;
+  visibility: visible;
+  background-color: #ef4444;
+  border-color: #ef4444;
+  color: white;
+}
+
+.docyard-code-block__copy.is-error:hover {
+  background-color: #dc2626;
+  border-color: #dc2626;
+  color: white;
+}
+
+/* Mobile: Always show copy button */
+@media (max-width: 1024px) {
+  .docyard-code-block__copy {
+    opacity: 1;
+    visibility: visible;
+  }
+}
+
+/* Dark mode adjustments */
+.dark .docyard-code-block__copy {
+  background-color: var(--color-bg-secondary);
+  border-color: var(--color-border);
+}
+
+.dark .docyard-code-block__copy:hover {
+  background-color: var(--color-bg-tertiary);
+  border-color: var(--color-text-tertiary);
+}
+
+/* Keep success state using primary colors in dark mode */
+.dark .docyard-code-block__copy.is-success {
+  background-color: var(--color-primary);
+  border-color: var(--color-primary);
+}
+
+.dark .docyard-code-block__copy.is-success:hover {
+  background-color: var(--color-primary-hover);
+  border-color: var(--color-primary-hover);
+}
+
+.dark .docyard-code-block__copy.is-error {
+  background-color: #ef4444;
+  border-color: #ef4444;
+}
+
+/* Reduced motion support - WCAG accessibility requirement */
+@media (prefers-reduced-motion: reduce) {
+  .docyard-code-block__copy,
+  .docyard-code-block__copy svg {
+    transition: none;
+    animation: none;
+  }
+
+  .docyard-code-block__copy:active {
+    transform: none;
+  }
+}

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.css → components/navigation.css}

@@ -1,50 +1,5 @@
 /* Navigation Components */
 
-/* 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;
-}
-
 /* Sidebar navigation */
 .sidebar nav {
   flex: 1;
@@ -98,13 +53,15 @@
 }
 
 .sidebar nav a {
-  display: block;
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
   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);
+  transition: color var(--transition-fast);
   line-height: 1.4;
   font-weight: var(--font-weight-medium);
 }
@@ -193,7 +150,7 @@
   color: var(--color-text-secondary);
   text-decoration: none;
   border-radius: var(--radius-md);
-  transition: all var(--transition-fast);
+  transition: color var(--transition-fast);
   line-height: 1.4;
   font-weight: var(--font-weight-medium);
   background: none;
@@ -202,6 +159,13 @@
   cursor: pointer;
 }
 
+.nav-group-title {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  flex: 1;
+}
+
 .nav-group-toggle:hover {
   color: var(--color-text);
 }
@@ -212,14 +176,18 @@
 }
 
 .nav-group-icon {
+  display: inline-flex;
+  color: var(--color-text-tertiary);
+  flex-shrink: 0;
+}
+
+.nav-group-icon .docyard-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 {
+.nav-group-toggle[aria-expanded="true"] .nav-group-icon .docyard-icon {
   transform: rotate(90deg);
 }
 
@@ -239,8 +207,8 @@
   border: none;
   padding: var(--space-2);
   cursor: pointer;
-  width: 36px;
-  height: 36px;
+  width: 2.25rem;
+  height: 2.25rem;
   align-items: center;
   justify-content: center;
   border-radius: var(--radius-md);
@@ -256,3 +224,93 @@
     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: background-color 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;
+}
+
+/* Icon styling */
+.nav-item-icon {
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+
+.nav-item-icon .docyard-icon {
+  width: 1rem;
+  height: 1rem;
+}
+
+.nav-item-text {
+  flex: 1;
+}
+
+.nav-item-external {
+  display: inline-flex;
+  align-items: center;
+  opacity: 0.5;
+  flex-shrink: 0;
+}
+
+.nav-item-external .docyard-icon {
+  width: 0.75rem;
+  height: 0.75rem;
+}
+
+/* Reduced motion support */
+@media (prefers-reduced-motion: reduce) {
+  .sidebar nav a,
+  .nav-group-toggle,
+  .nav-group-icon .docyard-icon,
+  .nav-group-children,
+  .mobile-menu-toggle,
+  .sidebar-footer-link,
+  .external-icon {
+    transition: none;
+  }
+
+  .nav-group-toggle[aria-expanded="true"] .nav-group-icon .docyard-icon {
+    transform: none;
+  }
+}