salvia_rb 0.1.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 111770f5d7b2a6e7d086e0a12d568f24eef9011aed420f4257498f3ad442838a
+  data.tar.gz: 641a090af7f584e5d8d35d0c6dcf93c3529860869c3130049a3acd2fc12c99ee
+SHA512:
+  metadata.gz: acb426d04b64edbeda0788b13b462f0d5d12144f4717a8e5375ae9ada8deebefdc7725b8472a724900d45b521d04ba83111446d718286f580de86ab3819d5d40
+  data.tar.gz: dad6635b64693e7bdcd86dc4f7fbea89438ec6a6267e8a907b99b16602d6b1108060c18173ef454d85809f67618528ca6e8d8ca83ecd02b05c9af617ab936394

data/LICENSE.txt

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Hiroto Furugen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,235 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/Ruby-3.1+-CC342D?style=flat-square&logo=ruby" alt="Ruby">
+  <img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License">
+  <img src="https://img.shields.io/badge/Version-0.1.0-6A5ACD?style=flat-square" alt="Version">
+  <img src="https://img.shields.io/gem/v/salvia_rb?style=flat-square&color=ff6347" alt="Gem">
+</p>
+
+# 🌿 Salvia.rb
+
+> **"Wisdom for Rubyists."**
+>
+> A small, understandable Ruby MVC framework
+
+**SSR Islands Architecture** × **Tailwind** × **ActiveRecord** combined into a simple and clear Ruby Web framework.
+
+## Features
+
+- **🚀 Zero Configuration** - Works out of the box, customizable when needed
+- **Server-Rendered (HTML) First** - Return HTML, not JSON APIs
+- **🏝️ SSR Islands Architecture** - Server-side render Preact components with QuickJS
+- **Rails-like DSL** - Familiar `resources`, `root to:` routing
+- **ActiveRecord Integration** - Use models like Rails
+- **🐳 Docker Ready** - Auto-generated Dockerfile and docker-compose.yml
+- **No Node.js Required** - QuickJS for SSR, Deno for build
+
+## Installation
+
+```ruby
+gem "salvia_rb"
+```
+
+## Quick Start
+
+```bash
+# Install the gem
+gem install salvia_rb
+
+# Create a new app
+salvia new myapp
+cd myapp
+
+# Setup and start
+bundle install
+salvia ssr:build   # Build SSR bundle (requires Deno)
+salvia server      # Start server (Puma in dev, Falcon in prod)
+```
+
+Open http://localhost:9292 in your browser.
+
+### Zero Configuration
+
+Salvia works with minimal setup:
+
+```ruby
+# config.ru (3 lines!)
+require "salvia_rb"
+Salvia.configure { |c| c.root = __dir__ }
+run Salvia::Application.new
+```
+
+### One-liner Mode
+
+```ruby
+# app.rb
+require "salvia_rb"
+Salvia.run!  # Auto-selects server: Puma (dev) or Falcon (prod)
+```
+
+## Directory Structure
+
+```
+myapp/
+├── app/
+│   ├── controllers/
+│   │   ├── application_controller.rb
+│   │   └── home_controller.rb
+│   ├── models/
+│   │   └── application_record.rb
+│   ├── views/
+│   │   ├── layouts/
+│   │   │   └── application.html.erb
+│   │   └── home/
+│   │       └── index.html.erb
+│   └── islands/                # 🏝️ Island components
+│       └── Counter.js
+├── vendor/server/
+│   └── ssr_bundle.js           # SSR bundle (generated)
+├── config/
+│   ├── database.yml
+│   ├── environment.rb
+│   └── routes.rb
+├── db/
+│   └── migrate/
+├── public/
+│   └── assets/
+├── config.ru                   # 3 lines!
+├── Gemfile
+├── Dockerfile                  # Auto-generated
+└── docker-compose.yml          # Auto-generated
+```
+
+## Routing
+
+```ruby
+# config/routes.rb
+Salvia::Router.draw do
+  root to: "home#index"
+
+  get "/about", to: "pages#about"
+
+  resources :posts, only: [:index, :show, :create]
+end
+```
+
+## Controller
+
+```ruby
+class PostsController < ApplicationController
+  def index
+    @posts = Post.order(created_at: :desc)
+  end
+
+  def create
+    @post = Post.create!(title: params["title"])
+    render "posts/_post", locals: { post: @post }
+  end
+end
+```
+
+## 🏝️ SSR Islands
+
+Salvia's Islands Architecture supports server-side rendering (SSR).
+
+### Create an Island Component
+
+```jsx
+// app/islands/Counter.jsx
+import { h } from "preact";
+import { useState } from "preact/hooks";
+
+export function Counter({ initialCount = 0 }) {
+  const [count, setCount] = useState(initialCount);
+
+  return (
+    <div className="p-4 border rounded">
+      <p className="text-2xl font-bold">{count}</p>
+      <button
+        onClick={() => setCount(count + 1)}
+        className="px-4 py-2 bg-blue-500 text-white rounded"
+      >
+        +1
+      </button>
+    </div>
+  );
+}
+```
+
+### Use in ERB
+
+```erb
+<!-- app/views/home/index.html.erb -->
+<h1>Counter Demo</h1>
+
+<%# SSR + Client Hydration %>
+<%= island "Counter", { initialCount: 10 } %>
+```
+
+### Build SSR Bundle
+
+```bash
+salvia ssr:build
+```
+
+### How It Works
+
+```
+1. SSR: Render Preact components with QuickJS (0.3ms/render)
+2. HTML: Embed rendered result in ERB
+3. Hydrate: Client-side Preact hydrate()
+4. Interactive: Clicks and inputs work
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `salvia new APP_NAME` | Create a new application |
+| `salvia server` / `salvia s` | Start server (Puma dev / Falcon prod) |
+| `salvia dev` | Start server + CSS watch + SSR watch |
+| `salvia console` / `salvia c` | Start IRB console |
+| `salvia db:create` | Create database |
+| `salvia db:migrate` | Run migrations |
+| `salvia db:rollback` | Rollback last migration |
+| `salvia db:setup` | Create database and run migrations |
+| `salvia css:build` | Build Tailwind CSS |
+| `salvia css:watch` | Watch and rebuild CSS |
+| `salvia ssr:build` | Build SSR bundle |
+| `salvia ssr:watch` | Watch and rebuild SSR |
+| `salvia routes` | Display routes |
+| `salvia g controller NAME` | Generate controller |
+| `salvia g model NAME` | Generate model |
+
+## Docker
+
+Generated apps include Docker support:
+
+```bash
+# Development
+docker compose up
+
+# Production
+docker build -t myapp .
+docker run -p 9292:9292 -e RACK_ENV=production myapp
+```
+
+## Requirements
+
+- Ruby 3.1+
+- Deno (for SSR build)
+- SQLite3 (default) or PostgreSQL/MySQL
+
+## License
+
+MIT License - See [LICENSE](LICENSE.txt) for details.
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/genfuru011/Salvia).
+
+---
+
+<p align="center">
+  <strong>🌿 Salvia.rb</strong><br>
+  <em>"Simple, like a flower. Solid, like a gem."</em>
+</p>

data/assets/javascripts/islands.js

@@ -0,0 +1,26 @@
+// Salvia Islands - Client-side Hydration
+// Framework-agnostic island loader
+// Each island component must export a mount(element, props) function
+
+document.addEventListener('DOMContentLoaded', async () => {
+  const islands = document.querySelectorAll('[data-island]');
+  
+  for (const island of islands) {
+    const name = island.dataset.island;
+    const props = JSON.parse(island.dataset.props || '{}');
+    const hasSSR = island.innerHTML.trim().length > 0;
+    
+    try {
+      const module = await import(`/client/${name}.js`);
+      
+      if (typeof module.mount === 'function') {
+        module.mount(island, props, { hydrate: hasSSR });
+        console.log(`🏝️ Island ${hasSSR ? 'hydrated' : 'mounted'}: ${name}`);
+      } else {
+        console.error(`Island ${name} must export a mount() function`);
+      }
+    } catch (error) {
+      console.error(`Failed to load island: ${name}`, error);
+    }
+  }
+});

data/assets/scripts/build_ssr.ts

@@ -0,0 +1,261 @@
+#!/usr/bin/env -S deno run --allow-all
+/**
+ * Salvia Build Script
+ * 
+ * Build SSR Islands + Tailwind CSS
+ * 
+ * Usage:
+ *   deno run --allow-all build_ssr.ts
+ *   deno run --allow-all build_ssr.ts --watch
+ */
+
+import * as esbuild from "https://deno.land/x/esbuild@v0.24.2/mod.js";
+import { denoPlugins } from "jsr:@luca/esbuild-deno-loader@0.11";
+
+// Tailwind CSS (Deno)
+import postcss from "npm:postcss@8";
+import tailwindcss from "npm:tailwindcss@3";
+import autoprefixer from "npm:autoprefixer@10";
+
+const ISLANDS_DIR = "./app/islands";
+const SSR_OUTPUT_DIR = "./vendor/server";
+const CLIENT_OUTPUT_DIR = "./vendor/client";
+const CSS_INPUT = "./app/assets/stylesheets/application.tailwind.css";
+const CSS_OUTPUT = "./public/assets/stylesheets/tailwind.css";
+const WATCH_MODE = Deno.args.includes("--watch");
+const VERBOSE = Deno.args.includes("--verbose");
+
+// ============================================
+// Tailwind CSS Build
+// ============================================
+
+async function buildCSS() {
+  try {
+    const css = await Deno.readTextFile(CSS_INPUT);
+    
+    // Load Tailwind config
+    const config = {
+      content: [
+        "./app/views/**/*.erb",
+        "./app/islands/**/*.{js,jsx,tsx}",
+        "./public/assets/javascripts/**/*.js"
+      ],
+      theme: {
+        extend: {
+          colors: {
+            'salvia': {
+              50: '#f0f0ff',
+              100: '#e4e4ff',
+              200: '#cdcdff',
+              300: '#a8a8ff',
+              400: '#7c7cff',
+              500: '#6A5ACD',
+              600: '#5a4ab8',
+              700: '#4B0082',
+              800: '#3d006b',
+              900: '#2d0050',
+            }
+          }
+        },
+      },
+      plugins: [],
+    };
+
+    const result = await postcss([
+      tailwindcss(config),
+      autoprefixer(),
+    ]).process(css, { from: CSS_INPUT, to: CSS_OUTPUT });
+
+    await Deno.writeTextFile(CSS_OUTPUT, result.css);
+    console.log(`✅ Tailwind CSS built: ${CSS_OUTPUT}`);
+  } catch (error) {
+    console.error("❌ CSS build error:", error);
+  }
+}
+
+// ============================================
+// SSR Islands Build
+// ============================================
+
+interface IslandFile {
+  path: string;
+  name: string;
+  clientOnly: boolean;
+}
+
+async function findIslandFiles(): Promise<IslandFile[]> {
+  const files: IslandFile[] = [];
+  try {
+    for await (const entry of Deno.readDir(ISLANDS_DIR)) {
+      if (entry.isFile && (entry.name.endsWith(".tsx") || entry.name.endsWith(".jsx") || entry.name.endsWith(".js"))) {
+        const path = `${ISLANDS_DIR}/${entry.name}`;
+        const content = await Deno.readTextFile(path);
+        const clientOnly = content.trimStart().startsWith('"client only"') || 
+                          content.trimStart().startsWith("'client only'");
+        const name = entry.name.replace(/\.(tsx|jsx|js)$/, "");
+        files.push({ path, name, clientOnly });
+      }
+    }
+  } catch {
+    console.log("📁 app/islands directory not found. Skipping.");
+  }
+  return files;
+}
+
+async function buildSSR() {
+  const islandFiles = await findIslandFiles();
+  
+  if (islandFiles.length === 0) {
+    console.log("⚠️  No Island components found. Skipping SSR build.");
+    return;
+  }
+
+  const ssrFiles = islandFiles.filter(f => !f.clientOnly);
+  const clientFiles = islandFiles;  // All files go to client
+
+  if (VERBOSE) {
+    console.log("🔍 SSR targets:", ssrFiles.map(f => f.name));
+    console.log("🔍 Client targets:", clientFiles.map(f => f.name));
+  }
+
+  // Create output directories
+  await Deno.mkdir(SSR_OUTPUT_DIR, { recursive: true });
+  await Deno.mkdir(CLIENT_OUTPUT_DIR, { recursive: true });
+
+  try {
+    // SSR bundle (for QuickJS) - single bundle with all components
+    if (ssrFiles.length > 0) {
+      // Create a virtual entry point that exports all components
+      // Get just the filename from the path
+      const entryCode = ssrFiles.map(f => {
+        const filename = f.path.split("/").pop();
+        return `import ${f.name} from "./${filename}";`;
+      }).join("\n") + `
+import { h } from "https://esm.sh/preact@10.19.3";
+import renderToString from "https://esm.sh/preact-render-to-string@6.3.1?deps=preact@10.19.3";
+
+// Salvia SSR Runtime
+const components = {
+${ssrFiles.map(f => `  "${f.name}": ${f.name}`).join(",\n")}
+};
+
+globalThis.SalviaSSR = {
+  render: function(name, props) {
+    const Component = components[name];
+    if (!Component) {
+      throw new Error("Component not found: " + name);
+    }
+    const vnode = h(Component, props);
+    return renderToString(vnode);
+  }
+};
+`;
+      const entryPath = `${ISLANDS_DIR}/_ssr_entry.js`;
+      await Deno.writeTextFile(entryPath, entryCode);
+
+      await esbuild.build({
+        entryPoints: [entryPath],
+        bundle: true,
+        format: "iife",
+        outfile: `${SSR_OUTPUT_DIR}/ssr_bundle.js`,
+        platform: "neutral",
+        plugins: [...denoPlugins()],
+        external: [],
+        jsx: "automatic",
+        jsxImportSource: "preact",
+        banner: {
+          js: `// Salvia SSR Bundle - Generated at ${new Date().toISOString()}`,
+        },
+      });
+      
+      // Clean up temp file
+      await Deno.remove(entryPath);
+      
+      console.log(`✅ SSR bundle built: ${SSR_OUTPUT_DIR}/ssr_bundle.js (${ssrFiles.map(f => f.name).join(", ")})`);
+    }
+
+    // Client bundle (for hydration) - all files
+    await esbuild.build({
+      entryPoints: clientFiles.map(f => f.path),
+      bundle: true,
+      format: "esm",
+      outdir: CLIENT_OUTPUT_DIR,
+      platform: "browser",
+      plugins: [...denoPlugins()],
+      external: [],
+      jsx: "automatic",
+      jsxImportSource: "preact",
+      minify: true,
+      banner: {
+        js: `// Salvia Client Islands - Generated at ${new Date().toISOString()}`,
+      },
+    });
+    console.log(`✅ Client Islands built: ${CLIENT_OUTPUT_DIR}/ (${clientFiles.map(f => f.name).join(", ")})`);
+
+    // Generate manifest (which Islands are client only)
+    const manifest = Object.fromEntries(
+      islandFiles.map(f => [f.name, { clientOnly: f.clientOnly }])
+    );
+    await Deno.writeTextFile(
+      `${SSR_OUTPUT_DIR}/manifest.json`,
+      JSON.stringify(manifest, null, 2)
+    );
+    console.log(`✅ Manifest generated: ${SSR_OUTPUT_DIR}/manifest.json`);
+
+  } catch (error) {
+    console.error("❌ SSR build error:", error.message);
+  }
+}
+
+// ============================================
+// Main Build
+// ============================================
+
+async function build() {
+  await Promise.all([
+    buildCSS(),
+    buildSSR(),
+  ]);
+}
+
+async function watch() {
+  console.log("👀 Watching for file changes...");
+  
+  // Watch Islands and CSS source
+  const watchDirs = [ISLANDS_DIR, "./app/views", "./app/assets/stylesheets"];
+  
+  for (const dir of watchDirs) {
+    (async () => {
+      try {
+        const watcher = Deno.watchFs(dir);
+        let debounceTimer: number | undefined;
+        
+        for await (const event of watcher) {
+          if (event.kind === "modify" || event.kind === "create") {
+            clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(async () => {
+              console.log(`🔄 Changes detected in ${dir}, rebuilding...`);
+              await build();
+            }, 100);
+          }
+        }
+      } catch {
+        // Skip if directory doesn't exist
+      }
+    })();
+  }
+  
+  // Wait indefinitely
+  await new Promise(() => {});
+}
+
+// Main execution
+console.log("🌿 Salvia Build (SSR + Tailwind)");
+console.log("================================");
+await build();
+
+if (WATCH_MODE) {
+  await watch();
+} else {
+  await esbuild.stop();
+}

data/exe/salvia

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "salvia_rb/cli"
+
+Salvia::CLI.start(ARGV)
+