elder_docs 0.1.0 → 0.1.3

data/frontend/src/index.css

@@ -0,0 +1,215 @@
+@import url('https://fonts.googleapis.com/css2?family=Syne:wght@500;600;700&family=IBM+Plex+Sans:wght@400;500;600&family=Inter:wght@400;600;800&family=Space+Grotesk:wght@400;600;700&family=Oswald:wght@400;600;700&family=Fira+Code:wght@400;600&family=Roboto:wght@400;500;700&family=Open+Sans:wght@400;600;700&display=swap');
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    --bd-yellow: #f8d447;
+    --bd-charcoal: #000000;
+    --bd-ink: #121212;
+    --bd-white: #ffffff;
+    --bd-muted: #666666;
+    --bd-panel: #ffffff;
+    --bd-border: #000000;
+    
+    --bd-radius: 0px;
+    --font-heading: 'Syne';
+    --font-body: 'IBM Plex Sans';
+  }
+
+  * {
+    border-width: 0;
+  }
+
+  body {
+    font-family: var(--font-body), system-ui, -apple-system, BlinkMacSystemFont;
+    font-size: 15px;
+    line-height: 1.55;
+    color: var(--bd-ink);
+    background: var(--bd-white);
+    min-height: 100vh;
+  }
+
+  body::before {
+    display: none;
+  }
+
+  body::after {
+    display: none;
+  }
+
+  body[data-mounted='true'] .reveal {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+
+@layer components {
+  .app-shell {
+    position: relative;
+    z-index: 1;
+    width: 100%;
+    height: 100%;
+    display: flex;
+    background: #ffffff;
+  }
+
+  .surface {
+    background: var(--bd-panel);
+    border: 3px solid var(--bd-border);
+    box-shadow: 8px 8px 0px 0px var(--bd-border);
+    border-radius: var(--bd-radius);
+  }
+
+  .surface--glass {
+    backdrop-filter: none;
+    background: var(--bd-panel);
+  }
+
+  .surface--highlight {
+    border-color: var(--bd-border);
+    box-shadow: 4px 4px 0px 0px var(--bd-yellow);
+  }
+
+  .pill {
+    font-family: var(--font-heading), system-ui;
+    letter-spacing: 0.1em;
+    font-size: 0.7rem;
+    text-transform: uppercase;
+    border: 2px solid var(--bd-border);
+    padding: 0.35rem 1rem;
+    border-radius: var(--bd-radius);
+    font-weight: 700;
+    color: var(--bd-charcoal);
+    background: var(--bd-yellow);
+  }
+
+  .chip {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.25rem;
+    font-size: 0.7rem;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    padding: 0.3rem 0.9rem;
+    border-radius: var(--bd-radius);
+    border: 2px solid var(--bd-border);
+    font-weight: 700;
+    background: var(--bd-panel);
+    color: var(--bd-ink);
+  }
+
+  .btn-primary {
+    font-family: var(--font-heading), system-ui;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    font-size: 0.8rem;
+    background: var(--bd-charcoal);
+    color: var(--bd-white);
+    padding: 0.85rem 1.6rem;
+    border: 3px solid var(--bd-border);
+    border-radius: var(--bd-radius);
+    transition: transform 0.1s ease, box-shadow 0.1s ease;
+    font-weight: 700;
+    box-shadow: 4px 4px 0px 0px var(--bd-yellow);
+  }
+
+  .btn-primary:hover {
+    transform: translate(-2px, -2px);
+    box-shadow: 6px 6px 0px 0px var(--bd-yellow);
+  }
+
+  .btn-primary:active {
+    transform: translate(2px, 2px);
+    box-shadow: 0px 0px 0px 0px var(--bd-yellow);
+  }
+
+  .btn-secondary {
+    font-family: var(--font-heading), system-ui;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    font-size: 0.7rem;
+    background: var(--bd-panel);
+    color: var(--bd-ink);
+    padding: 0.75rem 1.3rem;
+    border: 2px solid var(--bd-border);
+    border-radius: var(--bd-radius);
+    transition: transform 0.1s ease;
+    font-weight: 700;
+  }
+
+  .btn-secondary:hover {
+    background: var(--bd-yellow);
+    color: var(--bd-charcoal);
+  }
+
+  .input-field {
+    background: var(--bd-panel);
+    border: 3px solid var(--bd-border);
+    color: var(--bd-ink);
+    border-radius: var(--bd-radius);
+    padding: 0.65rem 0.9rem;
+    transition: box-shadow 0.1s ease;
+    font-weight: 500;
+  }
+
+  .input-field:focus {
+    outline: none;
+    box-shadow: 4px 4px 0px 0px var(--bd-yellow);
+  }
+
+  .nav-card {
+    border-radius: var(--bd-radius);
+    border: 2px solid transparent;
+    background: transparent;
+    transition: transform 0.1s ease;
+  }
+
+  .nav-card:hover {
+    background: var(--bd-panel);
+    border: 2px solid var(--bd-border);
+    transform: translate(-2px, -2px);
+    box-shadow: 4px 4px 0px 0px var(--bd-charcoal);
+  }
+
+  .nav-card--active {
+    background: var(--bd-yellow);
+    border: 2px solid var(--bd-border);
+    color: var(--bd-charcoal);
+    box-shadow: 4px 4px 0px 0px var(--bd-charcoal);
+    transform: translate(-2px, -2px);
+  }
+
+  .reveal {
+    opacity: 0;
+    transform: translateY(15px);
+    transition: opacity 0.4s cubic-bezier(0.16, 1, 0.3, 1), transform 0.4s cubic-bezier(0.16, 1, 0.3, 1);
+  }
+}
+
+@keyframes floatGlow {
+  0% {
+    transform: translateY(0px);
+    opacity: 0.5;
+  }
+  50% {
+    transform: translateY(-12px);
+    opacity: 1;
+  }
+  100% {
+    transform: translateY(0px);
+    opacity: 0.5;
+  }
+}
+
+@keyframes shimmer {
+  0% {
+    background-position: 0% 50%;
+  }
+  100% {
+    background-position: 200% 50%;
+  }
+}
+

data/frontend/src/main.jsx

@@ -0,0 +1,11 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import App from './App'
+import './index.css'
+
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+)
+

data/frontend/tailwind.config.js

@@ -0,0 +1,40 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  theme: {
+    extend: {
+      fontFamily: {
+        sans: ['Inter', 'system-ui', 'sans-serif'],
+      },
+      fontSize: {
+        'xs': '16px',
+        'sm': '18px',
+        'base': '20px',
+        'lg': '24px',
+        'xl': '28px',
+        '2xl': '32px',
+        '3xl': '40px',
+        '4xl': '48px',
+      },
+      colors: {
+        'yellow': {
+          50: '#FFFBEB',
+          100: '#FEF3C7',
+          200: '#FDE68A',
+          300: '#FCD34D',
+          400: '#FBBF24',
+          500: '#F59E0B',
+          600: '#D97706',
+        }
+      },
+      borderRadius: {
+        'none': '0',
+      }
+    },
+  },
+  plugins: [],
+}
+

data/frontend/vite.config.js

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  build: {
+    outDir: 'dist',
+    assetsDir: 'assets',
+    rollupOptions: {
+      output: {
+        manualChunks: undefined
+      }
+    }
+  },
+  base: './'
+})
+

data/lib/elder_docs/cli.rb

@@ -8,7 +8,7 @@ module ElderDocs
     desc 'deploy', 'Generate and deploy API documentation'
     method_option :definitions, type: :string, default: 'definitions.json', aliases: '-d'
     method_option :articles, type: :string, default: 'articles.json', aliases: '-a'
-    method_option :output, type: :string, default: nil, aliases: '-o'
+    method_option :output, type: :string, default: nil, aliases: '-o', desc: 'Directory to write built assets (default: public/elderdocs)'
     method_option :api_server, type: :string, default: nil, desc: 'Default API server URL'
     method_option :skip_build, type: :boolean, default: false, desc: 'Skip frontend build if assets exist'
     method_option :force_build, type: :boolean, default: false, desc: 'Force rebuilding frontend assets'
@@ -29,10 +29,14 @@ module ElderDocs
         File.write(articles_path, [].to_json)
       end
       
+      output_path = File.expand_path(options[:output] || default_output_path, Dir.pwd)
+      
+      ElderDocs.config.output_path = output_path
+      
       generator = Generator.new(
         definitions_path: definitions_path,
         articles_path: articles_path,
-        output_path: options[:output] || default_output_path,
+        output_path: output_path,
         api_server: options[:api_server],
         skip_build: options[:skip_build],
         force_build: options[:force_build]
@@ -62,7 +66,7 @@ module ElderDocs
     private
     
     def default_output_path
-      File.join(File.dirname(__FILE__), '..', '..', 'lib', 'elder_docs', 'assets', 'viewer')
+      ElderDocs.config.output_path || File.join(Dir.pwd, 'public', 'elderdocs')
     end
   end
 end

data/lib/elder_docs/config.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
 require 'yaml'
+require 'pathname'
 
 module ElderDocs
   class Config
-    attr_accessor :mount_path, :api_server, :auth_types, :ui_config, :admin_password
+    attr_accessor :mount_path, :api_server, :auth_types, :ui_config, :admin_password, :output_path
     
     def initialize
       @mount_path = nil
@@ -12,6 +13,8 @@ module ElderDocs
       @auth_types = ['bearer', 'api_key', 'basic', 'oauth2']
       @ui_config = {}
       @admin_password = nil
+      @api_servers = []
+      @output_path = default_output_path
       load_config_file
     end
     
@@ -29,19 +32,34 @@ module ElderDocs
       return unless config_path
       
       begin
-          config = YAML.load_file(config_path)
-          @mount_path = config['mount_path'] if config['mount_path']
-          @api_server = config['api_server'] if config['api_server']
-          @api_servers = config['api_servers'] if config['api_servers']
-          @auth_types = config['auth_types'] if config['auth_types']
-          @ui_config = config['ui'] if config['ui']  # YAML uses 'ui' key, but we store as ui_config
-          @admin_password = config['admin_password'] if config['admin_password']
-        rescue => e
-          warn "Warning: Could not load elderdocs.yml: #{e.message}"
+        config = YAML.load_file(config_path)
+        config_dir = File.dirname(config_path)
+        @mount_path = config['mount_path'] if config['mount_path']
+        @api_server = config['api_server'] if config['api_server']
+        @api_servers = config['api_servers'] if config['api_servers']
+        @auth_types = config['auth_types'] if config['auth_types']
+        @ui_config = config['ui'] if config['ui']  # YAML uses 'ui' key, but we store as ui_config
+        @admin_password = config['admin_password'] if config['admin_password']
+        if config['output_path']
+          @output_path = File.expand_path(config['output_path'], config_dir)
         end
+      rescue => e
+        warn "Warning: Could not load elderdocs.yml: #{e.message}"
       end
+    end
+    
+    def default_output_path
+      base_path =
+        if defined?(Rails) && Rails.root
+          Rails.root
+        else
+          Pathname.new(Dir.pwd)
+        end
       
-      attr_reader :api_servers
+      base_path.join('public', 'elderdocs').to_s
+    end
+    
+    attr_reader :api_servers
     
     def self.instance
       @instance ||= new

data/lib/elder_docs/engine.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'pathname'
+
 module ElderDocs
   class Engine < ::Rails::Engine
     isolate_namespace ElderDocs
@@ -47,7 +49,7 @@ module ElderDocs
       include ActionController::MimeResponds
       
       def show
-        viewer_path = Engine.root.join('lib', 'elder_docs', 'assets', 'viewer')
+        viewer_path = resolve_viewer_path
         requested_path = params[:path]
         requested_path = requested_path.present? ? requested_path : 'index'
         requested_path = [requested_path, params[:format]].compact.join('.')
@@ -69,6 +71,19 @@ module ElderDocs
       
       private
       
+      def resolve_viewer_path
+        custom_path = ElderDocs.config.output_path
+        if custom_path && Dir.exist?(custom_path)
+          Pathname.new(custom_path)
+        else
+          fallback_viewer_path
+        end
+      end
+      
+      def fallback_viewer_path
+        Engine.root.join('lib', 'elder_docs', 'assets', 'viewer')
+      end
+      
       def mime_type_for(file_path)
         ext = File.extname(file_path.to_s)
         case ext

data/lib/elder_docs/generator.rb

@@ -13,7 +13,7 @@ module ElderDocs
     def initialize(definitions_path:, articles_path:, output_path:, api_server: nil, skip_build: false, force_build: false)
       @definitions_path = definitions_path
       @articles_path = articles_path
-      @output_path = output_path
+      @output_path = File.expand_path(output_path, Dir.pwd)
       @api_server = api_server
       @skip_build = skip_build
       @force_build = force_build
@@ -185,12 +185,28 @@ module ElderDocs
     def build_frontend!
       say '🔨 Building frontend...', :cyan
       
-      frontend_dir = File.join(File.dirname(__FILE__), '..', '..', 'frontend')
+      # Try multiple locations for frontend directory
+      # 1. Relative to lib (development repo)
+      # 2. At gem root (installed gem)
+      # 3. Using Engine.root if available (Rails context)
+      possible_paths = [
+        File.join(File.dirname(__FILE__), '..', '..', 'frontend'), # Development: lib/elder_docs/../../frontend
+        File.join(File.dirname(__FILE__), '..', '..', '..', 'frontend'), # Installed gem: lib/elder_docs/../../../frontend
+      ]
       
-      unless Dir.exist?(frontend_dir)
-        raise ValidationError, "Frontend directory not found at #{frontend_dir}"
+      # If Engine is available, try relative to gem root
+      if defined?(ElderDocs::Engine) && ElderDocs::Engine.root
+        possible_paths << ElderDocs::Engine.root.join('frontend').to_s
       end
       
+      frontend_dir = possible_paths.find { |path| Dir.exist?(path) }
+      
+      unless frontend_dir && Dir.exist?(frontend_dir)
+        raise ValidationError, "Frontend directory not found. Tried: #{possible_paths.join(', ')}"
+      end
+      
+      frontend_dir = File.expand_path(frontend_dir)
+      
       # Write compiled data to frontend public directory
       public_dir = File.join(frontend_dir, 'public')
       FileUtils.mkdir_p(public_dir)
@@ -240,13 +256,12 @@ module ElderDocs
       index_html_path = File.join(output_path, 'index.html')
       if File.exist?(index_html_path)
         html_content = File.read(index_html_path, encoding: 'UTF-8')
-        # Replace relative paths with paths relative to mount point
-        html_content.gsub!(/src="\.\//, 'src="/docs/')
-        html_content.gsub!(/href="\.\//, 'href="/docs/')
-        html_content.gsub!(/src="\/assets\//, 'src="/docs/assets/')
-        html_content.gsub!(/href="\/assets\//, 'href="/docs/assets/')
-        # Fix data.js path
-        html_content.gsub!(/src="\/data\.js/, 'src="/docs/data.js')
+        mount_path = normalized_mount_path
+        html_content.gsub!(/src="\.\//, %{src="#{mount_path}/})
+        html_content.gsub!(/href="\.\//, %{href="#{mount_path}/})
+        html_content.gsub!(/src="\/assets\//, %{src="#{mount_path}/assets/})
+        html_content.gsub!(/href="\/assets\//, %{href="#{mount_path}/assets/})
+        html_content.gsub!(/src="\/data\.js/, %{src="#{mount_path}/data.js})
         File.write(index_html_path, html_content)
       end
       
@@ -258,6 +273,14 @@ module ElderDocs
       
       Thor::Base.shell.new.say(message, color)
     end
+    
+    def normalized_mount_path
+      mount_path = ElderDocs.config.mount_path || '/docs'
+      mount_path = "/#{mount_path}" unless mount_path.start_with?('/')
+      mount_path = '/' if mount_path == '//'
+      mount_path = mount_path.chomp('/')
+      mount_path.empty? ? '' : mount_path
+    end
   end
 end
 

data/lib/elder_docs/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module ElderDocs
-  VERSION = '0.1.0'
+  VERSION = '0.1.3'
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elder_docs
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - ElderDocs
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -107,6 +107,21 @@ files:
 - README.md
 - elderdocs.yml.example
 - exe/elderdocs
+- frontend/index.html
+- frontend/package.json
+- frontend/postcss.config.js
+- frontend/public/data.js
+- frontend/src/App.jsx
+- frontend/src/UiConfigApp.jsx
+- frontend/src/components/ApiExplorer.jsx
+- frontend/src/components/ContentPanel.jsx
+- frontend/src/components/Sidebar.jsx
+- frontend/src/components/UiConfigurator.jsx
+- frontend/src/contexts/ApiKeyContext.jsx
+- frontend/src/index.css
+- frontend/src/main.jsx
+- frontend/tailwind.config.js
+- frontend/vite.config.js
 - lib/elder_docs.rb
 - lib/elder_docs/assets/ui_config.html
 - lib/elder_docs/assets/viewer/assets/index-161b367b.css