salvia_rb 0.1.5

data/lib/salvia_rb/router.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+require "mustermann"
+require "active_support/core_ext/string/inflections"
+
+module Salvia
+  # Rails ライクな DSL ルーター（Mustermann ベース）
+  #
+  # @example
+  #   Salvia::Router.draw do
+  #     root to: "home#index"
+  #     get "/about", to: "pages#about"
+  #     resources :todos, only: [:index, :create, :destroy]
+  #   end
+  #
+  class Router
+    HTTP_METHODS = %i[get post put patch delete].freeze
+
+    Route = Struct.new(:method, :pattern, :controller, :action, keyword_init: true) do
+      def match?(request_method, path)
+        method.to_s.upcase == request_method && pattern.match(path)
+      end
+
+      def params_from(path)
+        pattern.params(path) || {}
+      end
+    end
+
+    class << self
+      def instance
+        @instance ||= new
+      end
+
+      def helpers
+        @helpers ||= Module.new
+      end
+
+      def draw(&block)
+        instance.instance_eval(&block)
+        instance
+      end
+
+      def recognize(request)
+        instance.recognize(request)
+      end
+
+      def reset!
+        @instance = nil
+      end
+    end
+
+    def initialize
+      @routes = []
+      @scope = { path: "", as: [] }
+    end
+
+    # ルートルートを定義
+    # @example root to: "home#index"
+    def root(to:)
+      get "/", to: to, as: "root"
+    end
+
+    # HTTP メソッドルートを定義
+    HTTP_METHODS.each do |method|
+      define_method(method) do |path, to:, as: nil|
+        controller, action = to.split("#")
+        add_route(method, path, controller, action, as: as)
+      end
+    end
+
+    # RESTful リソースヘルパー
+    # @example resources :todos, only: [:index, :create, :destroy]
+    def resources(name, only: nil, except: nil, &block)
+      actions = %i[index show new create edit update destroy]
+      actions = only if only
+      actions -= except if except
+
+      prefix = @scope[:as].join("_")
+      prefix = "#{prefix}_" unless prefix.empty?
+      singular = name.to_s.singularize
+
+      resource_routes = {
+        index:   [:get,    "/#{name}",               "#{prefix}#{name}"],
+        show:    [:get,    "/#{name}/:id",           "#{prefix}#{singular}"],
+        new:     [:get,    "/#{name}/new",           "#{prefix}new_#{singular}"],
+        create:  [:post,   "/#{name}",               nil],
+        edit:    [:get,    "/#{name}/:id/edit",      "#{prefix}edit_#{singular}"],
+        update:  [:patch,  "/#{name}/:id",           nil],
+        destroy: [:delete, "/#{name}/:id",           nil]
+      }
+
+      controller = name.to_s
+
+      actions.each do |action|
+        method, path, as = resource_routes[action]
+        add_route(method, path, controller, action.to_s, as: as) if method
+      end
+
+      if block_given?
+        parent_param = "#{singular}_id"
+        nested_path = "/#{name}/:#{parent_param}"
+        with_scope(path: nested_path, as: singular) do
+          block.call
+        end
+      end
+    end
+
+    # リクエストにマッチするルートを検索
+    # @param request [Rack::Request]
+    # @return [Array<Class, String, Hash>] [コントローラークラス, アクション, パラメータ] または nil
+    def recognize(request)
+      request_method = request.request_method
+      request_method = "GET" if request_method == "HEAD"
+      path = request.path_info
+
+      @routes.each do |route|
+        next unless route.match?(request_method, path)
+
+        controller_class = resolve_controller(route.controller)
+        return nil unless controller_class
+
+        params = route.params_from(path)
+        return [controller_class, route.action, params]
+      end
+
+      nil
+    end
+
+    # 登録されたルート一覧を取得（デバッグ用）
+    def routes
+      @routes.dup
+    end
+
+    private
+
+    def with_scope(options)
+      old_scope = @scope.dup
+      if options[:path]
+        @scope[:path] = File.join(@scope[:path], options[:path])
+      end
+      if options[:as]
+        @scope[:as] << options[:as]
+      end
+      yield
+    ensure
+      @scope = old_scope
+    end
+
+    def add_route(method, path, controller, action, as: nil)
+      full_path = File.join(@scope[:path], path)
+      pattern = Mustermann.new(full_path, type: :rails)
+
+      if as
+        helper_name = "#{as}_path"
+        Salvia::Router.helpers.define_method(helper_name) do |*args|
+          params = {}
+          params = args.pop if args.last.is_a?(Hash)
+          pattern.names.each_with_index do |name, i|
+            params[name] = args[i] if i < args.length
+          end
+          pattern.expand(params)
+        end
+      end
+
+      @routes << Route.new(
+        method: method,
+        pattern: pattern,
+        controller: controller,
+        action: action
+      )
+    end
+
+    def resolve_controller(name)
+      # "home" を "HomeController" に変換
+      class_name = "#{name.split('_').map(&:capitalize).join}Controller"
+      Object.const_get(class_name)
+    rescue NameError
+      nil
+    end
+  end
+end

data/lib/salvia_rb/ssr/quickjs.rb

@@ -0,0 +1,404 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Salvia
+  module SSR
+    # QuickJS SSR Engine
+    #
+    # Deno でビルドした ssr_bundle.js を読み込み、
+    # 同一プロセス内で高速に SSR を実行します。
+    #
+    # Features:
+    # - console.log を Ruby Logger に転送
+    # - SSR エラー時のオーバーレイ HTML 生成
+    # - 開発/本番モードの切り替え
+    #
+    # @example
+    #   Salvia::SSR.configure(bundle_path: "vendor/server/ssr_bundle.js")
+    #   html = Salvia::SSR.render("Counter", { count: 5 })
+    #
+    class QuickJS < BaseAdapter
+        # JS から収集したログを保持
+        attr_reader :js_logs
+        
+        # 最後のビルドエラー
+        attr_accessor :last_build_error
+
+        def setup!
+          require_quickjs!
+          
+          @js_logs = []
+          @last_build_error = nil
+          @development = options.fetch(:development, true)
+          
+          # JS ステートを初期化
+          @js_state = ""
+          
+          # console.log 転送用の shim をロード
+          load_console_shim!
+          
+          # Deno ビルド済みバンドルをロード
+          load_ssr_bundle!
+          
+          mark_initialized!
+        end
+
+        # コンポーネントを HTML にレンダリング
+        #
+        # @param component_name [String] コンポーネント名
+        # @param props [Hash] プロパティ
+        # @return [String] レンダリングされた HTML
+        def render(component_name, props = {})
+          raise Error, "Engine not initialized" unless initialized?
+          
+          # ビルドエラーがある場合は HUD を表示
+          if @last_build_error && @development
+            return build_error_html(@last_build_error)
+          end
+
+          js_code = <<~JS
+            (function() {
+              try {
+                if (typeof globalThis.SalviaSSR === 'undefined') {
+                  throw new Error('SalviaSSR runtime not loaded. Run: deno run --allow-all bin/build_ssr.ts');
+                }
+                return globalThis.SalviaSSR.render('#{escape_js(component_name)}', #{props.to_json});
+              } catch (e) {
+                return JSON.stringify({ __ssr_error__: true, message: e.message, stack: e.stack || '' });
+              }
+            })()
+          JS
+
+          result = eval_js(js_code)
+          
+          # エラーチェック
+          if result&.start_with?('{"__ssr_error__":true')
+            error_data = JSON.parse(result)
+            if @development
+              return ssr_error_overlay(component_name, error_data)
+            else
+              # 本番環境では空を返してクライアントサイドレンダリングにフォールバック
+              log_error("SSR Error in #{component_name}: #{error_data['message']}")
+              return ""
+            end
+          end
+          
+          result
+        end
+
+        # バンドルをリロード (開発モードでのホットリロード用)
+        def reload_bundle!
+          @js_state = ""
+          load_console_shim!
+          load_ssr_bundle!
+        end
+        
+        # JS ログをフラッシュして取得
+        def flush_logs
+          logs = @js_logs.dup
+          @js_logs.clear
+          logs
+        end
+
+        def shutdown!
+          @js_state = ""
+          @js_logs = []
+          @initialized = false
+        end
+
+        def engine_name
+          "QuickJS (Hybrid SSR Engine)"
+        end
+        
+        def development?
+          @development
+        end
+
+        private
+
+        def eval_js(code)
+          full_code = @js_state + "\n" + code
+          result = ::Quickjs.eval_code(full_code)
+          
+          # console.log の出力を処理
+          process_console_output(result)
+          
+          result
+        end
+        
+        # console.log/error/warn を Ruby に転送する shim
+        def load_console_shim!
+          shim = <<~JS
+            // Salvia Console Shim - Captures JS logs for Ruby
+            (function() {
+              var __salvia_logs__ = [];
+              
+              globalThis.console = {
+                log: function() {
+                  var msg = Array.prototype.slice.call(arguments).map(function(a) {
+                    return typeof a === 'object' ? JSON.stringify(a) : String(a);
+                  }).join(' ');
+                  __salvia_logs__.push({ level: 'log', message: msg });
+                },
+                error: function() {
+                  var msg = Array.prototype.slice.call(arguments).map(function(a) {
+                    return typeof a === 'object' ? JSON.stringify(a) : String(a);
+                  }).join(' ');
+                  __salvia_logs__.push({ level: 'error', message: msg });
+                },
+                warn: function() {
+                  var msg = Array.prototype.slice.call(arguments).map(function(a) {
+                    return typeof a === 'object' ? JSON.stringify(a) : String(a);
+                  }).join(' ');
+                  __salvia_logs__.push({ level: 'warn', message: msg });
+                },
+                info: function() {
+                  var msg = Array.prototype.slice.call(arguments).map(function(a) {
+                    return typeof a === 'object' ? JSON.stringify(a) : String(a);
+                  }).join(' ');
+                  __salvia_logs__.push({ level: 'info', message: msg });
+                },
+                debug: function() {
+                  var msg = Array.prototype.slice.call(arguments).map(function(a) {
+                    return typeof a === 'object' ? JSON.stringify(a) : String(a);
+                  }).join(' ');
+                  __salvia_logs__.push({ level: 'debug', message: msg });
+                }
+              };
+              
+              globalThis.__salvia_flush_logs__ = function() {
+                var logs = __salvia_logs__;
+                __salvia_logs__ = [];
+                return JSON.stringify(logs);
+              };
+            })();
+          JS
+          
+          @js_state += shim
+        end
+        
+        # ビルド済みバンドルをロード
+        def load_ssr_bundle!
+          bundle_path = options[:bundle_path] || default_bundle_path
+          
+          unless File.exist?(bundle_path)
+            if @development
+              # 開発モードではバンドルなしでも起動可能（ビルド待ち）
+              log_warn("SSR bundle not found: #{bundle_path}")
+              log_warn("Run: deno run --allow-all bin/build_ssr.ts")
+              return
+            else
+              raise Error, <<~MSG
+                SSR bundle not found: #{bundle_path}
+                
+                Build it with:
+                  deno run --allow-all bin/build_ssr.ts
+                
+                Or in production:
+                  salvia ssr:build
+              MSG
+            end
+          end
+          
+          bundle_content = File.read(bundle_path)
+          @js_state += "\n#{bundle_content}\n"
+          
+          log_info("Loaded SSR bundle: #{bundle_path} (#{(File.size(bundle_path) / 1024.0).round(1)}KB)")
+        end
+        
+        # console.log の出力を処理
+        def process_console_output(_result)
+          logs_json = ::Quickjs.eval_code(@js_state + "\nglobalThis.__salvia_flush_logs__()")
+          
+          return if logs_json.nil? || logs_json.empty?
+          
+          begin
+            logs = JSON.parse(logs_json)
+            logs.each do |log|
+              @js_logs << log
+              
+              # Ruby Logger にも出力
+              case log["level"]
+              when "error"
+                log_error("JS: #{log['message']}")
+              when "warn"
+                log_warn("JS: #{log['message']}")
+              else
+                log_debug("JS: #{log['message']}")
+              end
+            end
+          rescue JSON::ParserError
+            # ignore
+          end
+        end
+
+        # SSR エラー用のオーバーレイ HTML
+        def ssr_error_overlay(component_name, error_data)
+          <<~HTML
+            <div style="
+              background: linear-gradient(135deg, #fee 0%, #fcc 100%);
+              border: 2px solid #c00;
+              border-radius: 8px;
+              padding: 20px;
+              margin: 10px 0;
+              font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+              box-shadow: 0 4px 12px rgba(200, 0, 0, 0.15);
+            ">
+              <div style="display: flex; align-items: center; gap: 10px; margin-bottom: 15px;">
+                <span style="font-size: 24px;">💥</span>
+                <h3 style="margin: 0; color: #900; font-size: 16px;">
+                  SSR Error in <code style="background: #fff; padding: 2px 6px; border-radius: 4px;">#{escape_html(component_name)}</code>
+                </h3>
+              </div>
+              <pre style="
+                background: #1a1a2e;
+                color: #ff6b6b;
+                padding: 15px;
+                border-radius: 6px;
+                overflow-x: auto;
+                font-size: 13px;
+                line-height: 1.5;
+                margin: 0;
+              ">#{escape_html(error_data['message'])}</pre>
+              #{stack_trace_html(error_data['stack'])}
+              <p style="margin: 15px 0 0 0; color: #666; font-size: 12px;">
+                💡 This error overlay is only shown in development mode.
+              </p>
+            </div>
+          HTML
+        end
+        
+        def stack_trace_html(stack)
+          return "" if stack.nil? || stack.empty?
+          
+          <<~HTML
+            <details style="margin-top: 10px;">
+              <summary style="cursor: pointer; color: #666; font-size: 13px;">Stack Trace</summary>
+              <pre style="
+                background: #2a2a3e;
+                color: #aaa;
+                padding: 10px;
+                border-radius: 4px;
+                font-size: 11px;
+                margin-top: 5px;
+                overflow-x: auto;
+              ">#{escape_html(stack)}</pre>
+            </details>
+          HTML
+        end
+        
+        # ビルドエラー用の HUD HTML
+        def build_error_html(error_message)
+          <<~HTML
+            <div style="
+              position: fixed;
+              inset: 0;
+              background: rgba(0, 0, 0, 0.9);
+              z-index: 99999;
+              display: flex;
+              align-items: center;
+              justify-content: center;
+              padding: 40px;
+            ">
+              <div style="
+                background: #1a1a2e;
+                border: 2px solid #ff6b6b;
+                border-radius: 12px;
+                padding: 30px;
+                max-width: 800px;
+                width: 100%;
+                max-height: 80vh;
+                overflow: auto;
+              ">
+                <div style="display: flex; align-items: center; gap: 12px; margin-bottom: 20px;">
+                  <span style="font-size: 32px;">🚨</span>
+                  <h2 style="margin: 0; color: #ff6b6b; font-size: 20px;">
+                    SSR Build Failed
+                  </h2>
+                </div>
+                <pre style="
+                  background: #0d0d1a;
+                  color: #ff6b6b;
+                  padding: 20px;
+                  border-radius: 8px;
+                  overflow-x: auto;
+                  font-size: 13px;
+                  line-height: 1.6;
+                  margin: 0;
+                  white-space: pre-wrap;
+                  word-break: break-word;
+                ">#{escape_html(error_message)}</pre>
+                <p style="margin: 20px 0 0 0; color: #888; font-size: 13px;">
+                  Fix the error and save the file. The page will reload automatically.
+                </p>
+              </div>
+            </div>
+          HTML
+        end
+
+        def default_bundle_path
+          File.join(Dir.pwd, "vendor", "server", "ssr_bundle.js")
+        end
+
+        def require_quickjs!
+          require "quickjs"
+        rescue LoadError
+          raise Error, <<~MSG
+            quickjs gem is not installed.
+            
+            Add to your Gemfile:
+              gem 'quickjs'
+            
+            Then run:
+              bundle install
+          MSG
+        end
+
+        def escape_js(str)
+          str.to_s.gsub(/['\\]/) { |c| "\\#{c}" }
+        end
+        
+        def escape_html(str)
+          str.to_s
+            .gsub("&", "&amp;")
+            .gsub("<", "&lt;")
+            .gsub(">", "&gt;")
+            .gsub('"', "&quot;")
+        end
+        
+        # ロギングヘルパー
+        def log_info(msg)
+          if defined?(Salvia.logger)
+            Salvia.logger.info(msg)
+          else
+            puts "[SSR] #{msg}"
+          end
+        end
+        
+        def log_warn(msg)
+          if defined?(Salvia.logger)
+            Salvia.logger.warn(msg)
+          else
+            puts "[SSR WARNING] #{msg}"
+          end
+        end
+        
+        def log_error(msg)
+          if defined?(Salvia.logger)
+            Salvia.logger.error(msg)
+          else
+            puts "[SSR ERROR] #{msg}"
+          end
+        end
+        
+        def log_debug(msg)
+          if defined?(Salvia.logger)
+            Salvia.logger.debug(msg)
+          else
+            puts "[SSR DEBUG] #{msg}" if ENV["DEBUG"]
+          end
+        end
+    end
+  end
+end

data/lib/salvia_rb/ssr.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Salvia
+  module SSR
+    class Error < StandardError; end
+    class EngineNotFoundError < Error; end
+    class RenderError < Error; end
+
+    # SSR アダプターの基底クラス
+    class BaseAdapter
+      attr_reader :options
+
+      def initialize(options = {})
+        @options = options
+        @initialized = false
+      end
+
+      # エンジンを初期化
+      def setup!
+        raise NotImplementedError, "#{self.class}#setup! must be implemented"
+      end
+
+      # コンポーネントをレンダリング
+      # @param component_name [String] コンポーネント名
+      # @param props [Hash] プロパティ
+      # @return [String] レンダリングされた HTML
+      def render(component_name, props = {})
+        raise NotImplementedError, "#{self.class}#render must be implemented"
+      end
+
+      # コンポーネントを登録
+      # @param name [String] コンポーネント名
+      # @param code [String] コンポーネントの JS コード
+      def register_component(name, code)
+        raise NotImplementedError, "#{self.class}#register_component must be implemented"
+      end
+
+      # エンジンをシャットダウン
+      def shutdown!
+        # オーバーライド可能
+      end
+
+      def initialized?
+        @initialized
+      end
+
+      # エンジン名
+      def engine_name
+        raise NotImplementedError
+      end
+
+      protected
+
+      def mark_initialized!
+        @initialized = true
+      end
+    end
+
+    class << self
+      attr_accessor :current_adapter
+      attr_accessor :last_build_error
+
+      # SSR エンジンを設定
+      # @param options [Hash] エンジンオプション
+      # @option options [String] :bundle_path SSR バンドルのパス
+      # @option options [Boolean] :development 開発モード
+      def configure(options = {})
+        require_relative "ssr/quickjs"
+        @current_adapter = QuickJS.new(options)
+        @current_adapter.setup!
+        @current_adapter
+      end
+
+      # コンポーネントをレンダリング
+      # @param component_name [String] コンポーネント名
+      # @param props [Hash] プロパティ
+      # @return [String] レンダリングされた HTML
+      def render(component_name, props = {})
+        raise Error, "SSR not configured. Call Salvia::SSR.configure first." unless current_adapter
+        current_adapter.render(component_name, props)
+      end
+
+      # コンポーネントを登録
+      def register_component(name, code)
+        raise Error, "SSR not configured. Call Salvia::SSR.configure first." unless current_adapter
+        current_adapter.register_component(name, code)
+      end
+      
+      # バンドルをリロード (開発モード用)
+      def reload!
+        return unless current_adapter
+        current_adapter.reload_bundle! if current_adapter.respond_to?(:reload_bundle!)
+      end
+      
+      # ビルドエラーを設定
+      def set_build_error(error)
+        @last_build_error = error
+        current_adapter.last_build_error = error if current_adapter&.respond_to?(:last_build_error=)
+      end
+      
+      # ビルドエラーをクリア
+      def clear_build_error
+        @last_build_error = nil
+        current_adapter.last_build_error = nil if current_adapter&.respond_to?(:last_build_error=)
+      end
+
+      # シャットダウン
+      def shutdown!
+        current_adapter&.shutdown!
+        @current_adapter = nil
+      end
+
+      # 設定済みか確認
+      def configured?
+        !current_adapter.nil? && current_adapter.initialized?
+      end
+    end
+  end
+end