docyard 0.6.0 → 0.7.0

data/lib/docyard/server/resolution_result.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Docyard
+  class ResolutionResult
+    attr_reader :file_path, :status
+
+    def self.found(file_path)
+      new(file_path: file_path, status: :found)
+    end
+
+    def self.not_found
+      new(file_path: nil, status: :not_found)
+    end
+
+    def initialize(file_path:, status:)
+      @file_path = file_path
+      @status = status
+      freeze
+    end
+
+    def found?
+      status == :found
+    end
+
+    def not_found?
+      status == :not_found
+    end
+  end
+end

data/lib/docyard/{router.rb → server/router.rb}

@@ -12,18 +12,18 @@ module Docyard
       clean_path = sanitize_path(request_path)
 
       file_path = File.join(docs_path, "#{clean_path}#{Constants::MARKDOWN_EXTENSION}")
-      return Routing::ResolutionResult.found(file_path) if File.file?(file_path)
+      return ResolutionResult.found(file_path) if File.file?(file_path)
 
       index_path = File.join(docs_path, clean_path, "#{Constants::INDEX_FILE}#{Constants::MARKDOWN_EXTENSION}")
-      return Routing::ResolutionResult.found(index_path) if File.file?(index_path)
+      return ResolutionResult.found(index_path) if File.file?(index_path)
 
-      Routing::ResolutionResult.not_found
+      ResolutionResult.not_found
     end
 
     private
 
     def sanitize_path(request_path)
-      clean = request_path.delete_prefix("/")
+      clean = request_path.delete_prefix("/").delete_suffix("/")
       clean = Constants::INDEX_FILE if clean.empty?
       clean.delete_suffix(Constants::MARKDOWN_EXTENSION)
     end

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

@@ -0,0 +1,549 @@
+/* Search Trigger Button */
+.search-trigger {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  padding: 8px 14px;
+  background-color: var(--color-bg-secondary);
+  border: 1px solid var(--color-border);
+  border-radius: 12px;
+  cursor: pointer;
+  color: var(--color-text-tertiary);
+  font-size: var(--text-xs);
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+  min-width: 280px;
+}
+
+.search-trigger:hover {
+  border-color: var(--color-border-secondary);
+}
+
+.search-trigger:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+.search-trigger-icon {
+  display: flex;
+  flex-shrink: 0;
+}
+
+.search-trigger-icon svg {
+  width: 16px;
+  height: 16px;
+  opacity: 1;
+}
+
+.search-trigger-text {
+  flex: 1;
+  text-align: left;
+  color: var(--color-text-tertiary);
+  font-size: var(--text-xs);
+}
+
+.search-trigger-shortcut {
+  display: flex;
+  align-items: center;
+  gap: 2px;
+  font-family: var(--font-mono);
+  font-size: 11px;
+  color: var(--color-text-secondary);
+  background: none;
+  border: none;
+  padding: 0;
+}
+
+.search-trigger-shortcut-icon {
+  display: flex;
+}
+
+.search-trigger-shortcut-icon svg {
+  width: 14px;
+  height: 14px;
+  opacity: 1;
+}
+
+.search-trigger-shortcut-text {
+  opacity: 0.9;
+}
+
+/* Hide command icon on non-Mac, show "Ctrl" text instead */
+.search-trigger-shortcut[data-os="windows"] .search-trigger-shortcut-icon {
+  display: none;
+}
+
+.search-trigger-shortcut[data-os="windows"] .search-trigger-shortcut-text::before {
+  content: "Ctrl ";
+}
+
+/* Header Actions Container */
+.header-actions {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+}
+
+/* Search Modal */
+.search-modal {
+  position: fixed;
+  inset: 0;
+  z-index: 100;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: 16px;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.15s ease, visibility 0.15s ease;
+}
+
+.search-modal.is-open {
+  opacity: 1;
+  visibility: visible;
+}
+
+.search-modal[hidden] {
+  display: none;
+}
+
+.search-modal-backdrop {
+  position: fixed;
+  inset: 0;
+  background-color: rgba(0, 0, 0, 0.15);
+  opacity: 0;
+  transition: opacity 0.15s ease;
+}
+
+.search-modal.is-open .search-modal-backdrop {
+  opacity: 1;
+}
+
+.dark .search-modal-backdrop {
+  background-color: rgba(0, 0, 0, 0.5);
+}
+
+.search-modal-container {
+  position: relative;
+  width: 100%;
+  max-width: 640px;
+  max-height: calc(100vh - 100px);
+  margin: 0 var(--space-4);
+  background-color: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: 16px;
+  box-shadow: 0 25px 80px rgba(0, 0, 0, 0.15);
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  transform: scale(0.98) translateY(-8px);
+  opacity: 0;
+  transition: transform 0.2s ease, opacity 0.15s ease;
+}
+
+.search-modal.is-open .search-modal-container {
+  transform: scale(1) translateY(0);
+  opacity: 1;
+}
+
+.dark .search-modal-container {
+  box-shadow: 0 16px 70px rgba(0, 0, 0, 0.5);
+}
+
+/* Search Modal Header */
+.search-modal-header {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  padding: 16px 20px;
+}
+
+.search-modal-icon {
+  flex-shrink: 0;
+  width: 20px;
+  height: 20px;
+  color: var(--color-text-tertiary);
+}
+
+.search-modal-input {
+  flex: 1;
+  border: none;
+  background: transparent;
+  font-size: 16px;
+  color: var(--color-text);
+  outline: none;
+}
+
+.search-modal-input::placeholder {
+  color: var(--color-text-tertiary);
+}
+
+.search-modal-close {
+  display: flex;
+  align-items: center;
+  padding: 0;
+  background: none;
+  border: none;
+  cursor: pointer;
+}
+
+.search-modal-close-text {
+  font-family: var(--font-mono);
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: var(--color-text-tertiary);
+  background-color: var(--color-bg-secondary);
+  border: 1px solid var(--color-border);
+  border-radius: 4px;
+  padding: 3px 6px;
+}
+
+.search-modal-close:hover .search-modal-close-text {
+  color: var(--color-text-secondary);
+  border-color: var(--color-border-secondary);
+}
+
+/* Search Modal Body */
+.search-modal-body {
+  flex: 1;
+  max-height: 400px;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  padding: var(--space-3);
+  border-top: 1px solid var(--color-border);
+}
+
+.search-modal-body[hidden] {
+  display: none;
+}
+
+.search-modal-loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--space-6) var(--space-4);
+  color: var(--color-text-tertiary);
+  font-size: var(--text-sm);
+}
+
+.search-modal-loading[hidden] {
+  display: none;
+}
+
+.search-modal-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: var(--space-8) var(--space-4);
+  text-align: center;
+  gap: var(--space-2);
+}
+
+.search-modal-empty[hidden] {
+  display: none;
+}
+
+.search-empty-icon {
+  width: 48px;
+  height: 48px;
+  color: var(--color-border);
+  margin-bottom: var(--space-2);
+}
+
+.search-empty-title {
+  font-size: var(--text-base);
+  font-weight: 500;
+  color: var(--color-text-secondary);
+}
+
+.search-empty-hint {
+  font-size: var(--text-sm);
+  color: var(--color-text-tertiary);
+}
+
+.search-modal-spinner {
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--color-border);
+  border-top-color: var(--color-primary);
+  border-radius: 50%;
+  animation: search-spin 0.6s linear infinite;
+}
+
+@keyframes search-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* Search Results */
+.search-modal-results {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.search-modal-results[hidden] {
+  display: none;
+}
+
+/* Result Group (page + its sections) */
+.search-result-group {
+  list-style: none;
+}
+
+.search-result-group+.search-result-group {
+  margin-top: var(--space-1);
+}
+
+/* Base result link */
+.search-result {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--space-3);
+  padding: 10px 12px;
+  border-radius: 8px;
+  cursor: pointer;
+  text-decoration: none;
+  color: var(--color-text);
+  transition: background-color 0.1s ease;
+}
+
+.search-result:hover,
+.search-result[aria-selected="true"] {
+  background-color: var(--color-bg-tertiary, rgba(0, 0, 0, 0.06));
+  text-decoration: none;
+}
+
+.search-result:hover .search-result-title,
+.search-result[aria-selected="true"] .search-result-title {
+  color: var(--color-primary);
+  text-decoration: none;
+}
+
+.dark .search-result:hover,
+.dark .search-result[aria-selected="true"] {
+  background-color: rgba(255, 255, 255, 0.08);
+}
+
+.search-result-icon {
+  flex-shrink: 0;
+  width: 16px;
+  height: 16px;
+  margin-top: 2px;
+  color: var(--color-text-tertiary);
+}
+
+.search-result-content {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+  flex: 1;
+}
+
+.search-result-title {
+  font-size: var(--text-sm);
+  font-weight: 500;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  text-decoration: none;
+}
+
+.search-result-excerpt {
+  font-size: var(--text-xs);
+  color: var(--color-text-tertiary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  line-height: 1.4;
+}
+
+.search-result-excerpt mark {
+  background-color: color-mix(in srgb, var(--color-primary) 15%, transparent);
+  color: inherit;
+  font-weight: inherit;
+  border-radius: 2px;
+  padding: 0 1px;
+}
+
+/* Title highlight - light background like Stripe */
+.search-title-highlight {
+  background-color: color-mix(in srgb, var(--color-primary) 15%, transparent);
+  color: inherit;
+  font-weight: inherit;
+  border-radius: 2px;
+  padding: 0 1px;
+}
+
+/* Page-level results */
+.search-result-page {
+  font-weight: 500;
+}
+
+/* Sections list */
+.search-result-sections {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  padding-left: 12px;
+}
+
+.search-result-section-item {
+  position: relative;
+}
+
+/* Section result */
+.search-result-section {
+  padding-left: 20px;
+}
+
+.search-result-section .search-result-title {
+  font-weight: 400;
+  color: var(--color-text-secondary);
+}
+
+.search-result-section:hover .search-result-title,
+.search-result-section[aria-selected="true"] .search-result-title {
+  color: var(--color-primary);
+}
+
+/* Tree connector line */
+.search-result-tree-line {
+  position: absolute;
+  left: 12px;
+  top: 0;
+  bottom: 50%;
+  width: 12px;
+  border-left: 1px solid var(--color-border);
+  border-bottom: 1px solid var(--color-border);
+  border-radius: 0 0 0 4px;
+}
+
+.search-result-section-item:last-child .search-result-tree-line {
+  bottom: 50%;
+}
+
+/* Continuous line for middle items */
+.search-result-section-item:not(:last-child)::before {
+  content: '';
+  position: absolute;
+  left: 12px;
+  top: 50%;
+  bottom: -50%;
+  width: 1px;
+  background-color: var(--color-border);
+}
+
+/* Load More Link */
+.search-load-more {
+  list-style: none;
+  padding: var(--space-3) var(--space-3);
+}
+
+.search-load-more-btn {
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--color-primary);
+  background: none;
+  border: none;
+  padding: 0;
+  cursor: pointer;
+}
+
+.search-load-more-btn:hover {
+  opacity: 0.8;
+}
+
+.search-load-more-btn:focus {
+  outline: none;
+}
+
+/* Search Modal Footer */
+.search-modal-footer {
+  display: flex;
+  align-items: center;
+  gap: var(--space-4);
+  padding: 12px 20px;
+  border-top: 1px solid var(--color-border);
+  background-color: var(--color-bg-secondary);
+  font-size: 11px;
+  color: var(--color-text-tertiary);
+}
+
+.search-modal-hint {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.search-modal-hint kbd {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 18px;
+  height: 18px;
+  padding: 0 4px;
+  font-family: var(--font-mono);
+  font-size: 10px;
+  background-color: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: 3px;
+}
+
+/* Mobile Responsive */
+@media (max-width: 640px) {
+  .search-trigger {
+    min-width: auto;
+    padding: var(--space-2);
+    border-radius: var(--radius-md);
+  }
+
+  .search-trigger-text,
+  .search-trigger-shortcut {
+    display: none;
+  }
+
+  .search-trigger-icon {
+    opacity: 0.7;
+  }
+
+  .search-modal {
+    padding-top: 0;
+    align-items: stretch;
+  }
+
+  .search-modal-container {
+    max-width: 100%;
+    max-height: 100%;
+    margin: 0;
+    border-radius: 0;
+    border: none;
+  }
+
+  .search-modal-body {
+    max-height: calc(100vh - 160px);
+  }
+
+  .search-modal-footer {
+    flex-wrap: wrap;
+    gap: var(--space-2);
+  }
+}
+
+/* Reduced Motion */
+@media (prefers-reduced-motion: reduce) {
+  .search-modal-spinner {
+    animation: none;
+  }
+
+  .search-modal,
+  .search-modal-backdrop,
+  .search-modal-container,
+  .search-trigger,
+  .search-result {
+    transition: none;
+  }
+}

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

@@ -26,11 +26,25 @@
 .header-content {
   display: flex;
   align-items: center;
-  justify-content: space-between;
   height: 100%;
   padding: var(--space-5) var(--space-6);
 }
 
+.header-logo {
+  flex-shrink: 0;
+}
+
+.header-center {
+  flex: 1;
+  display: flex;
+  justify-content: center;
+  padding: 0 var(--space-6);
+}
+
+.header-actions {
+  flex-shrink: 0;
+}
+
 .header-left {
   display: flex;
   align-items: center;