salvia 0.2.0 → 0.2.1

data/lib/salvia/ssr.rb

@@ -62,11 +62,20 @@ module Salvia
 
       # SSR エンジンを設定
       # @param options [Hash] エンジンオプション
+      # @option options [Symbol] :engine エンジン名 (:quickjs)
       # @option options [String] :bundle_path SSR バンドルのパス
       # @option options [Boolean] :development 開発モード
       def configure(options = {})
-        require_relative "ssr/quickjs"
-        @current_adapter = QuickJS.new(options)
+        engine = options.fetch(:engine, :quickjs)
+        
+        case engine
+        when :quickjs
+          require_relative "ssr/quickjs"
+          @current_adapter = QuickJS.new(options)
+        else
+          raise EngineNotFoundError, "Unknown SSR engine: #{engine}"
+        end
+
         @current_adapter.setup!
         @current_adapter
       end
@@ -76,19 +85,19 @@ module Salvia
       # @param props [Hash] プロパティ
       # @return [String] レンダリングされた HTML
       def render(component_name, props = {})
-        raise Error, "SSR not configured. Call Salvia::SSR.configure first." unless current_adapter
+        ensure_configured!
         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
+        ensure_configured!
         current_adapter.register_component(name, code)
       end
       
       # バンドルをリロード (開発モード用)
       def reload!
-        return unless current_adapter
+        return unless configured?
         current_adapter.reload_bundle! if current_adapter.respond_to?(:reload_bundle!)
       end
       
@@ -98,6 +107,16 @@ module Salvia
         current_adapter.last_build_error = error if current_adapter&.respond_to?(:last_build_error=)
       end
       
+      # ビルドエラーを取得
+      def build_error
+        @last_build_error || (current_adapter&.respond_to?(:last_build_error) ? current_adapter.last_build_error : nil)
+      end
+
+      # ビルドエラーがあるか確認
+      def build_error?
+        !build_error.nil?
+      end
+      
       # ビルドエラーをクリア
       def clear_build_error
         @last_build_error = nil
@@ -114,6 +133,23 @@ module Salvia
       def configured?
         !current_adapter.nil? && current_adapter.initialized?
       end
+
+      private
+
+      def ensure_configured!
+        return if configured?
+        
+        # Auto-configure using defaults from Salvia.config
+        # This handles cases where Salvia.configure wasn't explicitly called
+        # or called before SSR module was fully loaded
+        configure(
+          bundle_path: Salvia.config.ssr_bundle_path,
+          development: Salvia.development?
+        )
+      rescue => e
+        # If auto-configuration fails, we raise the original error to avoid masking it
+        raise Error, "SSR not configured and auto-configuration failed: #{e.message}. Call Salvia::SSR.configure explicitly."
+      end
     end
   end
 end

data/lib/salvia/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Salvia
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: salvia
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Hiroto Furugen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-11 00:00:00.000000000 Z
+date: 2025-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -94,8 +94,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
-description: A standalone SSR engine for Ruby, bringing Islands Architecture to any
-  Rack application without Node.js.
+description: A standalone SSR engine for Ruby that brings Islands Architecture to
+  any Rack application. Write JSX/TSX components and render them server-side without
+  Node.js, JSON APIs, or complex build steps.
 email:
 - hiro_genfuru0119@icloud.com
 executables:
@@ -103,8 +104,10 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".vscode/settings.json"
+- Gemfile
 - LICENSE.txt
-- README.md
+- Rakefile
 - assets/components/Island.tsx
 - assets/islands/Counter.tsx
 - assets/javascripts/islands.js
@@ -114,6 +117,8 @@ files:
 - assets/scripts/deno.lock
 - assets/scripts/sidecar.ts
 - assets/scripts/vendor_setup.ts
+- bin/console
+- bin/setup
 - exe/salvia
 - lib/salvia.rb
 - lib/salvia/cli.rb
@@ -161,5 +166,5 @@ requirements: []
 rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
-summary: Ruby Islands Architecture Engine
+summary: 'Ruby Islands Architecture Engine: SSR with JSX/TSX for Rails & Rack'
 test_files: []

data/README.md

@@ -1,152 +0,0 @@
-# Salvia 🌿
-
-> **The Future of Rails View Layer**
-
-Salvia is a next-generation **Server-Side Rendering (SSR) engine** designed to replace ERB with **JSX/TSX** in Ruby on Rails. It brings the **Islands Architecture** and **True HTML First** philosophy to the Rails ecosystem.
-
-<img src="https://img.shields.io/gem/v/salvia?style=flat-square&color=ff6347" alt="Gem">
-
-## Vision: The Road to Sage
-
-Salvia is the core engine for a future MVC framework called **Sage**.
-While Sage will be a complete standalone framework, Salvia is available *today* as a drop-in replacement for the View layer in **Ruby on Rails**.
-
-## Features
-
-*   🏝️ **Islands Architecture**: Render interactive components (Preact/React) only where needed. Zero JS for static content.
-*   🚀 **True HTML First**: Replace `app/views/**/*.erb` with `app/pages/**/*.tsx`.
-*   ⚡ **JIT Compilation**: No build steps during development. Just run `rails s`.
-*   💎 **Rails Native**: Seamless integration with Controllers, Routes, and Models.
-*   🦕 **Deno Powered**: Uses Deno for lightning-fast TypeScript compilation and formatting.
-
-## Installation
-
-Add this line to your Rails application's Gemfile:
-
-```ruby
-gem 'salvia'
-```
-
-And then execute:
-
-```bash
-$ bundle install
-```
-
-## Getting Started
-
-### 1. Install Salvia
-
-Run the interactive installer to set up Salvia for your Rails project:
-
-```bash
-$ bundle exec salvia install
-```
-
-This creates the `salvia/` directory structure and configures your app with a **Zero Config** setup (Preact + Signals).
-
-### 2. Create a Page (Server Component)
-
-Delete `app/views/home/index.html.erb` and create `salvia/app/pages/home/Index.tsx`:
-
-```tsx
-import { h } from 'preact';
-
-export default function Home({ title }) {
-  return (
-    <div class="p-10">
-      <h1 class="text-3xl font-bold">{title}</h1>
-      <p>This is rendered on the server with 0kb JavaScript sent to the client.</p>
-    </div>
-  );
-}
-```
-
-### 3. Render in Controller
-
-In your Rails controller:
-
-```ruby
-class HomeController < ApplicationController
-  def index
-    # Renders salvia/app/pages/home/Index.tsx
-    render html: ssr("home/Index", title: "Hello Salvia")
-  end
-end
-```
-
-### 4. Add Interactivity (Islands)
-
-Create an interactive component in `salvia/app/islands/Counter.tsx`:
-
-```tsx
-import { h } from 'preact';
-import { useState } from 'preact/hooks';
-
-export default function Counter() {
-  const [count, setCount] = useState(0);
-  return (
-    <button onClick={() => setCount(count + 1)} class="btn">
-      Count: {count}
-    </button>
-  );
-}
-```
-
-Use it in your Page:
-
-```tsx
-import Counter from '../../islands/Counter.tsx';
-
-export default function Home() {
-  return (
-    <div>
-      <h1>Interactive Island</h1>
-      <Counter />
-    </div>
-  );
-}
-```
-
-### 4. Turbo Drive (Optional)
-
-Salvia works seamlessly with Turbo Drive for SPA-like navigation.
-
-Add Turbo to your layout file (e.g., `app/pages/layouts/Main.tsx`):
-
-```tsx
-<head>
-  {/* ... */}
-  <script type="module">
-    import * as Turbo from "https://esm.sh/@hotwired/turbo@8.0.0";
-    Turbo.start();
-  </script>
-</head>
-```
-
-This approach leverages Import Maps and browser-native modules, keeping your bundle size small and your architecture transparent.
-
-## Documentation
-
-*   **English**:
-    *   [**Wisdom for Salvia**](docs/en/DESIGN.md): Deep dive into the architecture, directory structure, and "True HTML First" philosophy.
-    *   [**Architecture**](docs/en/ARCHITECTURE.md): Internal design of the gem.
-*   **Japanese (日本語)**:
-    *   [**Salviaの知恵**](docs/ja/DESIGN.md): アーキテクチャ、ディレクトリ構造、「真のHTMLファースト」哲学についての詳細。
-    *   [**アーキテクチャ**](docs/ja/ARCHITECTURE.md): Gemの内部設計。
-
-## Framework Support
-
-Salvia is primarily designed for **Ruby on Rails** to pave the way for the **Sage** framework.
-
-*   **Ruby on Rails**: First-class support.
-
-## Requirements
-
-*   Ruby 3.1+
-*   Rails 7.0+ (Recommended)
-*   Deno (for JIT compilation and tooling)
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).