RubyGems - salvia_rb - Versions diffs - 0.1.5 - Mend

salvia_rb 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

checksums.yaml +7 -0
data/LICENSE.txt +22 -0
data/README.md +235 -0
data/assets/javascripts/islands.js +26 -0
data/assets/scripts/build_ssr.ts +261 -0
data/exe/salvia +7 -0
data/lib/salvia_rb/application.rb +431 -0
data/lib/salvia_rb/assets.rb +74 -0
data/lib/salvia_rb/assets_middleware.rb +46 -0
data/lib/salvia_rb/cli.rb +1398 -0
data/lib/salvia_rb/component.rb +74 -0
data/lib/salvia_rb/controller.rb +277 -0
data/lib/salvia_rb/csrf.rb +130 -0
data/lib/salvia_rb/database.rb +176 -0
data/lib/salvia_rb/flash.rb +43 -0
data/lib/salvia_rb/helpers/component.rb +31 -0
data/lib/salvia_rb/helpers/csrf.rb +47 -0
data/lib/salvia_rb/helpers/inspector.rb +192 -0
data/lib/salvia_rb/helpers/island.rb +143 -0
data/lib/salvia_rb/helpers/tag.rb +90 -0
data/lib/salvia_rb/helpers.rb +11 -0
data/lib/salvia_rb/plugins/base.rb +59 -0
data/lib/salvia_rb/router.rb +181 -0
data/lib/salvia_rb/ssr/quickjs.rb +404 -0
data/lib/salvia_rb/ssr.rb +119 -0
data/lib/salvia_rb/test.rb +20 -0
data/lib/salvia_rb/version.rb +5 -0
data/lib/salvia_rb.rb +250 -0
metadata +344 -0

data/lib/salvia_rb/helpers/component.rb ADDED Viewed

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+module Salvia
+  module Helpers
+    module Component
+      # View Component をレンダリングする
+      #
+      # @param name [String, Symbol] コンポーネント名 (例: "user_card")
+      # @param kwargs [Hash] コンポーネントに渡す引数
+      # @param block [Proc] コンテンツブロック
+      # @return [String] レンダリング結果
+      def component(name, **kwargs, &block)
+        # "user_card" -> "UserCardComponent"
+        class_name = "#{name.to_s.camelize}Component"
+        begin
+          klass = Object.const_get(class_name)
+        rescue NameError
+          raise NameError, "Component class not found: #{class_name} (expected app/components/#{name}_component.rb)"
+        end
+        unless klass < Salvia::Component
+          raise ArgumentError, "#{class_name} must inherit from Salvia::Component"
+        end
+        instance = klass.new(**kwargs)
+        instance.render_in(self, &block)
+      end
+    end
+  end
+end

data/lib/salvia_rb/helpers/csrf.rb ADDED Viewed

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+module Salvia
+  module Helpers
+    # CSRF 保護用ヘルパー
+    module CSRF
+      # CSRF トークンを取得
+      #
+      # @return [String] CSRF トークン
+      #
+      # @example
+      #   <input type="hidden" name="authenticity_token" value="<%= csrf_token %>">
+      #
+      def csrf_token
+        Salvia::CSRF.token(session)
+      end
+      # CSRF meta タグを生成
+      #
+      # @return [String] meta タグ HTML
+      #
+      # @example
+      #   <head>
+      #     <%= csrf_meta_tag %>
+      #   </head>
+      #
+      def csrf_meta_tag
+        %(<meta name="csrf-token" content="#{csrf_token}">)
+      end
+      alias csrf_meta_tags csrf_meta_tag
+      # CSRF hidden input を生成
+      #
+      # @return [String] hidden input HTML
+      #
+      # @example
+      #   <form method="post">
+      #     <%= csrf_field %>
+      #     ...
+      #   </form>
+      #
+      def csrf_field
+        %(<input type="hidden" name="authenticity_token" value="#{csrf_token}">)
+      end
+    end
+  end
+end

data/lib/salvia_rb/helpers/inspector.rb ADDED Viewed

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+module Salvia
+  module Helpers
+    # Island Inspector ヘルパー
+    #
+    # 開発モードで Island コンポーネントをデバッグするための
+    # ツールを提供します。
+    module Inspector
+      # Island Inspector のスクリプトとスタイルを読み込むタグを生成
+      #
+      # @return [String] script タグと style タグ
+      def island_inspector_tags
+        return "" unless Salvia.development? && Salvia.config.island_inspector?
+        css = inspector_css
+        js = inspector_js
+        "<style>#{css}</style>\n<script>#{js}</script>"
+      end
+      private
+      def inspector_css
+        <<~CSS
+          .salvia-island-highlight {
+            outline: 2px dashed #6B46C1 !important;
+            outline-offset: 2px;
+            position: relative;
+          }
+          .salvia-island-highlight::after {
+            content: attr(data-island);
+            position: absolute;
+            top: -20px;
+            left: 0;
+            background: #6B46C1;
+            color: white;
+            font-size: 10px;
+            padding: 2px 6px;
+            border-radius: 3px;
+            font-family: ui-monospace, monospace;
+            z-index: 10000;
+            pointer-events: none;
+          }
+          .salvia-inspector-panel {
+            position: fixed;
+            bottom: 20px;
+            right: 20px;
+            width: 320px;
+            max-height: 400px;
+            background: #1e1e1e;
+            color: #d4d4d4;
+            border-radius: 8px;
+            box-shadow: 0 4px 20px rgba(0,0,0,0.3);
+            font-family: ui-monospace, monospace;
+            font-size: 12px;
+            z-index: 10001;
+            overflow: hidden;
+          }
+          .salvia-inspector-header {
+            background: #6B46C1;
+            color: white;
+            padding: 8px 12px;
+            font-weight: bold;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+          }
+          .salvia-inspector-close {
+            background: none;
+            border: none;
+            color: white;
+            cursor: pointer;
+            font-size: 16px;
+            padding: 0 4px;
+          }
+          .salvia-inspector-content {
+            padding: 12px;
+            max-height: 340px;
+            overflow-y: auto;
+          }
+          .salvia-inspector-section {
+            margin-bottom: 12px;
+          }
+          .salvia-inspector-label {
+            color: #9cdcfe;
+            margin-bottom: 4px;
+          }
+          .salvia-inspector-value {
+            background: #2d2d2d;
+            padding: 6px 8px;
+            border-radius: 4px;
+            word-break: break-all;
+          }
+          .salvia-inspector-json {
+            white-space: pre-wrap;
+            color: #ce9178;
+          }
+        CSS
+      end
+      def inspector_js
+        <<~JS
+          (function() {
+            let currentPanel = null;
+            // Alt + Click でパネルを表示
+            document.addEventListener('click', function(e) {
+              if (!e.altKey) return;
+              const island = e.target.closest('[data-island]');
+              if (!island) return;
+              e.preventDefault();
+              e.stopPropagation();
+              showInspectorPanel(island);
+            });
+            // ホバー時にハイライト
+            document.addEventListener('mouseover', function(e) {
+              const island = e.target.closest('[data-island]');
+              if (island) {
+                island.classList.add('salvia-island-highlight');
+              }
+            });
+            document.addEventListener('mouseout', function(e) {
+              const island = e.target.closest('[data-island]');
+              if (island) {
+                island.classList.remove('salvia-island-highlight');
+              }
+            });
+            function showInspectorPanel(island) {
+              if (currentPanel) {
+                currentPanel.remove();
+              }
+              const name = island.dataset.island;
+              const props = JSON.parse(island.dataset.props || '{}');
+              const ssr = island.dataset.ssr === 'true';
+              const hydrated = island.dataset.hydrated === 'true';
+              const panel = document.createElement('div');
+              panel.className = 'salvia-inspector-panel';
+              panel.innerHTML = `
+                <div class="salvia-inspector-header">
+                  <span>🏝️ \${name}</span>
+                  <button class="salvia-inspector-close">×</button>
+                </div>
+                <div class="salvia-inspector-content">
+                  <div class="salvia-inspector-section">
+                    <div class="salvia-inspector-label">SSR</div>
+                    <div class="salvia-inspector-value">\${ssr ? '✅ Yes' : '❌ No'}</div>
+                  </div>
+                  <div class="salvia-inspector-section">
+                    <div class="salvia-inspector-label">Hydrated</div>
+                    <div class="salvia-inspector-value">\${hydrated ? '✅ Yes' : '⏳ Pending'}</div>
+                  </div>
+                  <div class="salvia-inspector-section">
+                    <div class="salvia-inspector-label">Props</div>
+                    <div class="salvia-inspector-value salvia-inspector-json">\${JSON.stringify(props, null, 2)}</div>
+                  </div>
+                </div>
+              `;
+              panel.querySelector('.salvia-inspector-close').addEventListener('click', function() {
+                panel.remove();
+                currentPanel = null;
+              });
+              document.body.appendChild(panel);
+              currentPanel = panel;
+            }
+            console.log('🔍 Salvia Island Inspector: Alt+Click on any island to inspect');
+          })();
+        JS
+      end
+    end
+  end
+end

data/lib/salvia_rb/helpers/island.rb ADDED Viewed

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+require "json"
+module Salvia
+  module Helpers
+    module Island
+      # Island マニフェストをキャッシュ
+      @manifest = nil
+      @manifest_mtime = nil
+      class << self
+        # マニフェストを読み込む
+        def load_manifest
+          manifest_path = File.join(Dir.pwd, "vendor/server/manifest.json")
+          return {} unless File.exist?(manifest_path)
+          mtime = File.mtime(manifest_path)
+          if @manifest.nil? || @manifest_mtime != mtime
+            @manifest = JSON.parse(File.read(manifest_path))
+            @manifest_mtime = mtime
+          end
+          @manifest
+        rescue => e
+          {}
+        end
+        # Island が client only かどうか
+        def client_only?(name)
+          manifest = load_manifest
+          manifest.dig(name, "clientOnly") == true
+        end
+      end
+      # Island コンポーネントをレンダリングする
+      #
+      # SSR が有効な場合はサーバーサイドで HTML を生成し、
+      # クライアントサイドでハイドレーションを行います。
+      #
+      # @param name [String] コンポーネント名 (例: "Counter")
+      # @param props [Hash] コンポーネントに渡すプロパティ
+      # @param options [Hash] オプション
+      # @option options [String] :id 要素のID
+      # @option options [String] :tag ラッパータグ (デフォルト: div)
+      # @option options [Boolean] :ssr SSR を有効にするか (デフォルト: auto)
+      # @option options [Boolean] :hydrate クライアントサイドでハイドレーションするか (デフォルト: true)
+      # @return [String] レンダリングされた HTML
+      #
+      # @example 基本的な使用法
+      #   <%= island "Counter", count: 5 %>
+      #
+      # @example SSR を明示的に無効化
+      #   <%= island "HeavyChart", data: @data, ssr: false %>
+      #
+      # @example ハイドレーションを無効化 (静的 HTML のみ)
+      #   <%= island "StaticCard", title: "Hello", hydrate: false %>
+      #
+      def island(name, props = {}, options = {})
+        tag_name = options.delete(:tag) || :div
+        hydrate = options.fetch(:hydrate, true)
+        # SSR 有効/無効の判定
+        # 1. options[:ssr] が明示的に指定されていればそれを使う
+        # 2. マニフェストで "client only" ならば SSR 無効
+        # 3. デフォルトは SSR 有効
+        ssr_enabled = if options.key?(:ssr)
+          options[:ssr]
+        else
+          !Island.client_only?(name)
+        end
+        # 開発モードかどうか
+        development = defined?(Salvia.env) ? Salvia.env == "development" : true
+        # SSR でコンテンツを生成
+        inner_html = ""
+        begin
+          if ssr_enabled && defined?(Salvia::SSR) && Salvia::SSR.respond_to?(:configured?) && Salvia::SSR.configured?
+            inner_html = Salvia::SSR.render(name, props)
+          end
+        rescue => e
+          # SSR 失敗時はエラーをログに出力し、CSR にフォールバック
+          if development
+            inner_html = ssr_error_inline(name, e.message)
+          end
+        end
+        # データ属性を構築
+        data_attrs = {}
+        if hydrate
+          data_attrs[:island] = name
+          data_attrs[:props] = props.to_json
+        end
+        # 開発モードではデバッグ用の属性を追加
+        if development
+          data_attrs[:salvia_debug] = true
+          data_attrs[:salvia_component] = name
+        end
+        # HTML オプションを構築
+        html_options = options.dup
+        html_options.delete(:ssr)
+        html_options.delete(:hydrate)
+        html_options[:data] = (html_options[:data] || {}).merge(data_attrs)
+        # 開発モードではインスペクター用のクラスを追加
+        if development
+          html_options[:class] = [html_options[:class], "salvia-island"].compact.join(" ")
+        end
+        tag(tag_name, html_options) { inner_html }
+      end
+      private
+      # インラインエラー表示 (開発モード用、軽量版)
+      def ssr_error_inline(name, message)
+        <<~HTML
+          <div style="
+            background: #fee;
+            border: 1px solid #fcc;
+            border-radius: 4px;
+            padding: 8px 12px;
+            font-size: 12px;
+            color: #900;
+          ">
+            <strong>⚠️ SSR Error:</strong> #{escape_html(name)} - #{escape_html(message)}
+          </div>
+        HTML
+      end
+      def escape_html(str)
+        str.to_s
+          .gsub("&", "&amp;")
+          .gsub("<", "&lt;")
+          .gsub(">", "&gt;")
+          .gsub('"', "&quot;")
+      end
+    end
+  end
+end

data/lib/salvia_rb/helpers/tag.rb ADDED Viewed

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+module Salvia
+  module Helpers
+    module Tag
+      # HTMLタグを生成する
+      #
+      # @param name [String, Symbol] タグ名
+      # @param options [Hash] 属性
+      # @param block [Proc] コンテンツブロック
+      # @return [String]
+      def tag(name, options = {}, &block)
+        html_options = options.dup
+        data = html_options.delete(:data)
+        attributes = html_options.map { |k, v| "#{k}=\"#{v.to_s.gsub('"', '&quot;')}\"" }
+        if data
+          data.each do |k, v|
+            key = k.to_s.tr("_", "-") # dasherize
+            attributes << "data-#{key}=\"#{v.to_s.gsub('"', '&quot;')}\""
+          end
+        end
+        attributes = attributes.join(" ")
+        attributes = " " + attributes unless attributes.empty?
+        if block_given?
+          content = block.call
+          "<#{name}#{attributes}>#{content}</#{name}>"
+        else
+          "<#{name}#{attributes}>"
+        end
+      end
+      # リンクタグを生成する
+      #
+      # @param name [String] リンクテキスト
+      # @param url [String] URL
+      # @param options [Hash] 属性
+      # @return [String]
+      def link_to(name, url, options = {})
+        tag(:a, options.merge(href: url)) { name }
+      end
+      # フォーム開始タグを生成する
+      #
+      # @param url [String] アクションURL
+      # @param options [Hash] オプション
+      # @option options [Symbol] :method HTTPメソッド (デフォルト: :post)
+      # @return [String]
+      def form_tag(url, options = {})
+        html_options = options.dup
+        method = html_options.delete(:method) || :post
+        # method が get/post 以外の場合、_method パラメータを使用
+        real_method = method.to_s.downcase
+        form_method = %w[get post].include?(real_method) ? real_method : "post"
+        html_options[:action] = url
+        html_options[:method] = form_method
+        # 属性を文字列化
+        attributes = html_options.map { |k, v| "#{k}=\"#{v}\"" }.join(" ")
+        attributes = " " + attributes unless attributes.empty?
+        html = ["<form#{attributes}>"]
+        # CSRF トークン (GET 以外)
+        if real_method != "get" && respond_to?(:csrf_token) && csrf_token
+          html << tag(:input, type: "hidden", name: "authenticity_token", value: csrf_token)
+        end
+        # Method Override
+        if real_method != form_method
+          html << tag(:input, type: "hidden", name: "_method", value: real_method)
+        end
+        html.join("\n")
+      end
+      # フォーム終了タグを生成する
+      #
+      # @return [String]
+      def form_close
+        "</form>"
+      end
+    end
+  end
+end

data/lib/salvia_rb/helpers.rb ADDED Viewed

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+module Salvia
+  module Helpers
+    include Tag
+    include Component
+    include Island
+    include Inspector
+    include CSRF
+  end
+end

data/lib/salvia_rb/plugins/base.rb ADDED Viewed

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+module Salvia
+  module Plugins
+    # プラグイン管理モジュール
+    #
+    # Salvia のオプショナル機能をプラグインとして管理します。
+    #
+    # @example プラグインの有効化
+    #   Salvia.configure do |config|
+    #     config.plugins << :htmx
+    #   end
+    #
+    module Base
+      class << self
+        # 登録済みプラグイン
+        def registry
+          @registry ||= {}
+        end
+        # プラグインを登録
+        def register(name, mod)
+          registry[name.to_sym] = mod
+        end
+        # プラグインを取得
+        def get(name)
+          registry[name.to_sym]
+        end
+        # プラグインが登録されているか確認
+        def registered?(name)
+          registry.key?(name.to_sym)
+        end
+        # 有効なプラグイン一覧
+        def enabled
+          @enabled ||= []
+        end
+        # プラグインを有効化
+        def enable(name)
+          plugin = get(name)
+          raise ArgumentError, "Unknown plugin: #{name}" unless plugin
+          enabled << name.to_sym unless enabled.include?(name.to_sym)
+          # プラグインの初期化メソッドがあれば呼び出す
+          plugin.setup if plugin.respond_to?(:setup)
+        end
+        # プラグインが有効か確認
+        def enabled?(name)
+          enabled.include?(name.to_sym)
+        end
+      end
+    end
+  end
+end