synthra 0.1.0

data/lib/synthra/live_preview.rb

@@ -0,0 +1,518 @@
+# frozen_string_literal: true
+
+require "webrick"
+require "json"
+require "erb"
+
+module Synthra
+  # Live Preview Server with Web UI
+  #
+  # Provides real-time schema preview with hot reload.
+  #
+  # @example CLI usage
+  #   $ synthra watch --live --port 4567
+  #
+  # @example Ruby usage
+  #   Synthra::LivePreview.start(port: 4567, schema_dir: "schemas/")
+  #
+  class LivePreview
+    DEFAULT_PORT = 4567
+    
+    attr_reader :port, :schema_dir, :server, :registry
+
+    def initialize(schema_dir:, port: DEFAULT_PORT)
+      @schema_dir = schema_dir
+      @port = port
+      @registry = Registry.new
+      @registry.load_dir(schema_dir)
+    end
+
+    def start
+      puts "🚀 Starting Synthra Live Preview Server..."
+      puts "   Schema directory: #{@schema_dir}"
+      puts "   URL: http://localhost:#{@port}"
+      puts ""
+      puts "   Press Ctrl+C to stop"
+
+      @server = WEBrick::HTTPServer.new(
+        Port: @port,
+        Logger: WEBrick::Log.new("/dev/null"),
+        AccessLog: []
+      )
+
+      setup_routes
+      setup_file_watcher
+
+      trap("INT") { @server.shutdown }
+      @server.start
+    end
+
+    private
+
+    def setup_routes
+      # Main page
+      @server.mount_proc "/" do |req, res|
+        if req.path == "/" || req.path == "/index.html"
+          res["Content-Type"] = "text/html"
+          res.body = render_index
+        else
+          res.status = 404
+        end
+      end
+
+      # API: List schemas
+      @server.mount_proc "/api/schemas" do |_, res|
+        res["Content-Type"] = "application/json"
+        res.body = JSON.pretty_generate(
+          schemas: @registry.names.sort
+        )
+      end
+
+      # API: Get schema details
+      @server.mount_proc "/api/schema" do |req, res|
+        name = req.query["name"]
+        res["Content-Type"] = "application/json"
+
+        if name && @registry.schema?(name)
+          schema = @registry.schema(name)
+          res.body = JSON.pretty_generate(
+            name: name,
+            fields: schema.fields.map { |f| { name: f.name, type: f.type_name, optional: f.optional } },
+            sample: schema.generate(seed: 42)
+          )
+        else
+          res.status = 404
+          res.body = JSON.generate(error: "Schema not found")
+        end
+      end
+
+      # API: Generate data
+      @server.mount_proc "/api/generate" do |req, res|
+        name = req.query["name"]
+        count = (req.query["count"] || "1").to_i
+        mode = (req.query["mode"] || "random").to_sym
+        seed = req.query["seed"]&.to_i
+
+        res["Content-Type"] = "application/json"
+
+        if name && @registry.schema?(name)
+          schema = @registry.schema(name)
+          data = if count > 1
+                   count.times.map { schema.generate(seed: seed, mode: mode) }
+                 else
+                   schema.generate(seed: seed, mode: mode)
+                 end
+          res.body = JSON.pretty_generate(data)
+        else
+          res.status = 404
+          res.body = JSON.generate(error: "Schema not found")
+        end
+      end
+
+      # API: Reload schemas
+      @server.mount_proc "/api/reload" do |_, res|
+        @registry.clear
+        @registry.load_dir(@schema_dir)
+        res["Content-Type"] = "application/json"
+        res.body = JSON.generate(
+          reloaded: true,
+          schemas: @registry.names.count
+        )
+      end
+    end
+
+    def setup_file_watcher
+      Thread.new do
+        last_mtime = Dir.glob("#{@schema_dir}/**/*.dsl").map { |f| File.mtime(f) }.max
+        
+        loop do
+          sleep 1
+          current_mtime = Dir.glob("#{@schema_dir}/**/*.dsl").map { |f| File.mtime(f) }.max rescue nil
+          
+          if current_mtime && last_mtime && current_mtime > last_mtime
+            puts "♻️  Detected schema changes, reloading..."
+            @registry.clear
+            @registry.load_dir(@schema_dir)
+            last_mtime = current_mtime
+          end
+        end
+      end
+    end
+
+    def render_index
+      <<~HTML
+        <!DOCTYPE html>
+        <html lang="en">
+        <head>
+          <meta charset="UTF-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <title>Synthra Live Preview</title>
+          <style>
+            :root {
+              --bg: #1a1b26;
+              --surface: #24283b;
+              --primary: #7aa2f7;
+              --secondary: #bb9af7;
+              --success: #9ece6a;
+              --warning: #e0af68;
+              --text: #c0caf5;
+              --text-muted: #565f89;
+              --border: #414868;
+            }
+            
+            * { box-sizing: border-box; }
+            
+            body {
+              font-family: 'JetBrains Mono', 'Fira Code', monospace;
+              background: var(--bg);
+              color: var(--text);
+              margin: 0;
+              padding: 0;
+              min-height: 100vh;
+            }
+            
+            .container {
+              max-width: 1400px;
+              margin: 0 auto;
+              padding: 2rem;
+            }
+            
+            header {
+              display: flex;
+              justify-content: space-between;
+              align-items: center;
+              margin-bottom: 2rem;
+              padding-bottom: 1rem;
+              border-bottom: 1px solid var(--border);
+            }
+            
+            h1 {
+              margin: 0;
+              font-size: 1.5rem;
+              background: linear-gradient(135deg, var(--primary), var(--secondary));
+              -webkit-background-clip: text;
+              -webkit-text-fill-color: transparent;
+            }
+            
+            .status {
+              display: flex;
+              align-items: center;
+              gap: 0.5rem;
+              color: var(--success);
+            }
+            
+            .status-dot {
+              width: 8px;
+              height: 8px;
+              background: var(--success);
+              border-radius: 50%;
+              animation: pulse 2s infinite;
+            }
+            
+            @keyframes pulse {
+              0%, 100% { opacity: 1; }
+              50% { opacity: 0.5; }
+            }
+            
+            .grid {
+              display: grid;
+              grid-template-columns: 300px 1fr;
+              gap: 2rem;
+            }
+            
+            .sidebar {
+              background: var(--surface);
+              border-radius: 8px;
+              padding: 1rem;
+              height: fit-content;
+            }
+            
+            .sidebar h2 {
+              font-size: 0.875rem;
+              color: var(--text-muted);
+              text-transform: uppercase;
+              margin: 0 0 1rem;
+            }
+            
+            .schema-list {
+              list-style: none;
+              padding: 0;
+              margin: 0;
+            }
+            
+            .schema-item {
+              padding: 0.75rem;
+              border-radius: 4px;
+              cursor: pointer;
+              transition: background 0.2s;
+            }
+            
+            .schema-item:hover {
+              background: var(--bg);
+            }
+            
+            .schema-item.active {
+              background: var(--primary);
+              color: var(--bg);
+            }
+            
+            .main {
+              display: flex;
+              flex-direction: column;
+              gap: 1rem;
+            }
+            
+            .controls {
+              display: flex;
+              gap: 1rem;
+              align-items: center;
+              flex-wrap: wrap;
+            }
+            
+            .control-group {
+              display: flex;
+              align-items: center;
+              gap: 0.5rem;
+            }
+            
+            label {
+              font-size: 0.75rem;
+              color: var(--text-muted);
+              text-transform: uppercase;
+            }
+            
+            input, select, button {
+              font-family: inherit;
+              font-size: 0.875rem;
+              padding: 0.5rem 1rem;
+              border: 1px solid var(--border);
+              border-radius: 4px;
+              background: var(--surface);
+              color: var(--text);
+            }
+            
+            input:focus, select:focus {
+              outline: none;
+              border-color: var(--primary);
+            }
+            
+            button {
+              cursor: pointer;
+              background: var(--primary);
+              color: var(--bg);
+              border: none;
+              font-weight: 600;
+              transition: transform 0.1s, box-shadow 0.2s;
+            }
+            
+            button:hover {
+              transform: translateY(-1px);
+              box-shadow: 0 4px 12px rgba(122, 162, 247, 0.3);
+            }
+            
+            button:active {
+              transform: translateY(0);
+            }
+            
+            .output {
+              background: var(--surface);
+              border-radius: 8px;
+              overflow: hidden;
+              flex: 1;
+            }
+            
+            .output-header {
+              display: flex;
+              justify-content: space-between;
+              align-items: center;
+              padding: 1rem;
+              border-bottom: 1px solid var(--border);
+            }
+            
+            .output-header h3 {
+              margin: 0;
+              font-size: 0.875rem;
+            }
+            
+            .copy-btn {
+              padding: 0.25rem 0.5rem;
+              font-size: 0.75rem;
+            }
+            
+            pre {
+              margin: 0;
+              padding: 1rem;
+              overflow: auto;
+              max-height: 600px;
+              font-size: 0.875rem;
+              line-height: 1.5;
+            }
+            
+            .json-key { color: var(--primary); }
+            .json-string { color: var(--success); }
+            .json-number { color: var(--warning); }
+            .json-boolean { color: var(--secondary); }
+            .json-null { color: var(--text-muted); }
+            
+            footer {
+              margin-top: 2rem;
+              padding-top: 1rem;
+              border-top: 1px solid var(--border);
+              text-align: center;
+              color: var(--text-muted);
+              font-size: 0.75rem;
+            }
+          </style>
+        </head>
+        <body>
+          <div class="container">
+            <header>
+              <h1>🎲 Synthra Live Preview</h1>
+              <div class="status">
+                <span class="status-dot"></span>
+                Watching for changes
+              </div>
+            </header>
+            
+            <div class="grid">
+              <aside class="sidebar">
+                <h2>Schemas</h2>
+                <ul class="schema-list" id="schema-list">
+                  <li class="schema-item">Loading...</li>
+                </ul>
+              </aside>
+              
+              <main class="main">
+                <div class="controls">
+                  <div class="control-group">
+                    <label>Count</label>
+                    <input type="number" id="count" value="5" min="1" max="100">
+                  </div>
+                  <div class="control-group">
+                    <label>Mode</label>
+                    <select id="mode">
+                      <option value="random">Random</option>
+                      <option value="edge">Edge Cases</option>
+                      <option value="invalid">Invalid</option>
+                      <option value="hostile">Hostile</option>
+                    </select>
+                  </div>
+                  <div class="control-group">
+                    <label>Seed</label>
+                    <input type="number" id="seed" placeholder="(optional)">
+                  </div>
+                  <button id="generate-btn">Generate</button>
+                  <button id="reload-btn" style="background: var(--secondary);">Reload Schemas</button>
+                </div>
+                
+                <div class="output">
+                  <div class="output-header">
+                    <h3 id="output-title">Select a schema to start</h3>
+                    <button class="copy-btn" id="copy-btn">Copy JSON</button>
+                  </div>
+                  <pre id="output">// Generated data will appear here</pre>
+                </div>
+              </main>
+            </div>
+            
+            <footer>
+              Synthra &bull; Hot Reload Enabled &bull; Schemas: <span id="schema-count">0</span>
+            </footer>
+          </div>
+          
+          <script>
+            let currentSchema = null;
+            let lastData = null;
+            
+            async function loadSchemas() {
+              const res = await fetch('/api/schemas');
+              const data = await res.json();
+              const list = document.getElementById('schema-list');
+              document.getElementById('schema-count').textContent = data.schemas.length;
+              
+              list.innerHTML = data.schemas.map(name => 
+                `<li class="schema-item" data-name="${name}">${name}</li>`
+              ).join('');
+              
+              list.querySelectorAll('.schema-item').forEach(item => {
+                item.addEventListener('click', () => selectSchema(item.dataset.name));
+              });
+            }
+            
+            function selectSchema(name) {
+              currentSchema = name;
+              document.querySelectorAll('.schema-item').forEach(item => {
+                item.classList.toggle('active', item.dataset.name === name);
+              });
+              document.getElementById('output-title').textContent = `Generated ${name}`;
+              generate();
+            }
+            
+            async function generate() {
+              if (!currentSchema) return;
+              
+              const count = document.getElementById('count').value;
+              const mode = document.getElementById('mode').value;
+              const seed = document.getElementById('seed').value;
+              
+              let url = `/api/generate?name=${currentSchema}&count=${count}&mode=${mode}`;
+              if (seed) url += `&seed=${seed}`;
+              
+              const res = await fetch(url);
+              const data = await res.json();
+              lastData = data;
+              
+              document.getElementById('output').innerHTML = syntaxHighlight(JSON.stringify(data, null, 2));
+            }
+            
+            async function reload() {
+              await fetch('/api/reload');
+              await loadSchemas();
+              if (currentSchema) generate();
+            }
+            
+            function syntaxHighlight(json) {
+              return json.replace(/("(\\\\u[a-zA-Z0-9]{4}|\\\\[^u]|[^\\\\"])*"(\\s*:)?|\\b(true|false|null)\\b|-?\\d+(?:\\.\\d*)?(?:[eE][+\\-]?\\d+)?)/g, function (match) {
+                let cls = 'json-number';
+                if (/^"/.test(match)) {
+                  if (/:$/.test(match)) {
+                    cls = 'json-key';
+                  } else {
+                    cls = 'json-string';
+                  }
+                } else if (/true|false/.test(match)) {
+                  cls = 'json-boolean';
+                } else if (/null/.test(match)) {
+                  cls = 'json-null';
+                }
+                return '<span class="' + cls + '">' + match + '</span>';
+              });
+            }
+            
+            function copyToClipboard() {
+              if (lastData) {
+                navigator.clipboard.writeText(JSON.stringify(lastData, null, 2));
+              }
+            }
+            
+            document.getElementById('generate-btn').addEventListener('click', generate);
+            document.getElementById('reload-btn').addEventListener('click', reload);
+            document.getElementById('copy-btn').addEventListener('click', copyToClipboard);
+            document.getElementById('count').addEventListener('change', generate);
+            document.getElementById('mode').addEventListener('change', generate);
+            document.getElementById('seed').addEventListener('change', generate);
+            
+            loadSchemas();
+          </script>
+        </body>
+        </html>
+      HTML
+    end
+
+    class << self
+      def start(**options)
+        new(**options).start
+      end
+    end
+  end
+end

data/lib/synthra/loader_config.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# =============================================================================
+# Synthra - Zeitwerk Loader Configuration
+# =============================================================================
+
+# Get the loader instance from main file
+loader = Zeitwerk::Loader.for_gem
+
+# Ignore domain folders (manually loaded for flat namespace)
+IGNORED_DOMAIN_FOLDERS = %w[
+  address_location finance_banking technology_internet commerce_products
+  media_entertainment personal_names text_content health_medical travel
+  date_time crypto core
+].freeze
+
+# Ignore deprecated files and domain folders
+%w[
+  address_location_types finance_banking_types technology_internet_types
+  commerce_product_types media_entertainment_types personal_names_types
+  text_content_types datetime hash time
+].each { |f| loader.ignore("#{__dir__}/synthra/types/#{f}.rb") }
+
+IGNORED_DOMAIN_FOLDERS.each do |folder|
+  loader.ignore("#{__dir__}/synthra/types/#{folder}")
+end
+
+# Ignore manually loaded modules
+loader.ignore("#{__dir__}/synthra/utils")
+loader.ignore("#{__dir__}/synthra/validator")
+loader.ignore("#{__dir__}/synthra/lsp")
+loader.ignore("#{__dir__}/synthra/repl")
+loader.ignore("#{__dir__}/synthra/cli/commands")
+loader.ignore("#{__dir__}/synthra/types/hostile_payloads.rb")
+
+# Ignore feature files (manually loaded)
+loader.ignore("#{__dir__}/synthra/api.rb")
+loader.ignore("#{__dir__}/synthra/type_definitions.rb")
+loader.ignore("#{__dir__}/synthra/config_file.rb")
+loader.ignore("#{__dir__}/synthra/schema_inheritance.rb")
+loader.ignore("#{__dir__}/synthra/factory_bot_integration.rb")
+loader.ignore("#{__dir__}/synthra/snapshot_testing.rb")
+loader.ignore("#{__dir__}/synthra/export/type_mapping.rb")
+loader.ignore("#{__dir__}/synthra/export/graphql.rb")
+
+# Ignore Phase 2 feature files (manually loaded)
+loader.ignore("#{__dir__}/synthra/rails_test_helper.rb")
+loader.ignore("#{__dir__}/synthra/mixin.rb")
+loader.ignore("#{__dir__}/synthra/relationships.rb")
+loader.ignore("#{__dir__}/synthra/schema_versioning.rb")
+loader.ignore("#{__dir__}/synthra/openapi_importer.rb")
+loader.ignore("#{__dir__}/synthra/database_seeder.rb")
+loader.ignore("#{__dir__}/synthra/live_preview.rb")
+loader.ignore("#{__dir__}/synthra/documentation_generator.rb")
+loader.ignore("#{__dir__}/synthra/deterministic_ids.rb")
+
+# Ignore Production-grade features (manually loaded)
+loader.ignore("#{__dir__}/synthra/export/protobuf.rb")
+loader.ignore("#{__dir__}/synthra/export/openapi.rb")
+loader.ignore("#{__dir__}/synthra/mock_server.rb")
+loader.ignore("#{__dir__}/synthra/contracts_registry.rb")
+loader.ignore("#{__dir__}/synthra/performance_mode.rb")
+loader.ignore("#{__dir__}/synthra/api_server.rb")
+
+# Ignore Rails-tier features (manually loaded)
+loader.ignore("#{__dir__}/synthra/engine.rb")
+loader.ignore("#{__dir__}/synthra/activerecord_inference.rb")
+loader.ignore("#{__dir__}/synthra/scenarios.rb")
+loader.ignore("#{__dir__}/synthra/personas.rb")
+loader.ignore("#{__dir__}/synthra/time_travel.rb")
+loader.ignore("#{__dir__}/synthra/quality_metrics.rb")
+loader.ignore("#{__dir__}/synthra/webhook_simulator.rb")
+loader.ignore("#{__dir__}/synthra/migration_generator.rb")
+loader.ignore("#{__dir__}/synthra/export/graphql_federation.rb")
+loader.ignore("#{__dir__}/synthra/export/terraform.rb")
+
+# Ignore Rails generators (loaded by Rails when available)
+loader.ignore("#{__dir__}/generators")