RubyGems - tina4ruby - Versions diffs - 0.5.2 → 3.0.0 - Mend

tina4ruby 0.5.2 → 3.0.0

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 (90) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +1 -1
data/README.md +360 -559
data/exe/{tina4 → tina4ruby} +1 -0
data/lib/tina4/ai.rb +312 -0
data/lib/tina4/auth.rb +44 -3
data/lib/tina4/auto_crud.rb +163 -0
data/lib/tina4/cli.rb +242 -77
data/lib/tina4/constants.rb +46 -0
data/lib/tina4/cors.rb +74 -0
data/lib/tina4/database/sqlite3_adapter.rb +139 -0
data/lib/tina4/database.rb +43 -7
data/lib/tina4/debug.rb +4 -79
data/lib/tina4/dev_admin.rb +1162 -0
data/lib/tina4/dev_mailbox.rb +191 -0
data/lib/tina4/dev_reload.rb +9 -9
data/lib/tina4/drivers/firebird_driver.rb +19 -3
data/lib/tina4/drivers/mssql_driver.rb +3 -3
data/lib/tina4/drivers/mysql_driver.rb +4 -4
data/lib/tina4/drivers/postgres_driver.rb +9 -2
data/lib/tina4/drivers/sqlite_driver.rb +1 -1
data/lib/tina4/env.rb +42 -2
data/lib/tina4/error_overlay.rb +252 -0
data/lib/tina4/events.rb +90 -0
data/lib/tina4/field_types.rb +4 -0
data/lib/tina4/frond.rb +1336 -0
data/lib/tina4/gallery/auth/meta.json +1 -0
data/lib/tina4/gallery/auth/src/routes/api/gallery_auth.rb +114 -0
data/lib/tina4/gallery/database/meta.json +1 -0
data/lib/tina4/gallery/database/src/routes/api/gallery_db.rb +43 -0
data/lib/tina4/gallery/error-overlay/meta.json +1 -0
data/lib/tina4/gallery/error-overlay/src/routes/api/gallery_crash.rb +17 -0
data/lib/tina4/gallery/orm/meta.json +1 -0
data/lib/tina4/gallery/orm/src/routes/api/gallery_products.rb +16 -0
data/lib/tina4/gallery/queue/meta.json +1 -0
data/lib/tina4/gallery/queue/src/routes/api/gallery_queue.rb +27 -0
data/lib/tina4/gallery/rest-api/meta.json +1 -0
data/lib/tina4/gallery/rest-api/src/routes/api/gallery_hello.rb +14 -0
data/lib/tina4/gallery/templates/meta.json +1 -0
data/lib/tina4/gallery/templates/src/routes/gallery_page.rb +12 -0
data/lib/tina4/gallery/templates/src/templates/gallery_page.twig +257 -0
data/lib/tina4/health.rb +39 -0
data/lib/tina4/html_element.rb +148 -0
data/lib/tina4/localization.rb +2 -2
data/lib/tina4/log.rb +203 -0
data/lib/tina4/messenger.rb +484 -0
data/lib/tina4/migration.rb +132 -29
data/lib/tina4/orm.rb +337 -31
data/lib/tina4/public/css/tina4.css +178 -1
data/lib/tina4/public/css/tina4.min.css +1 -2
data/lib/tina4/public/favicon.ico +0 -0
data/lib/tina4/public/images/logo.svg +5 -0
data/lib/tina4/public/images/tina4-logo-icon.webp +0 -0
data/lib/tina4/public/js/frond.min.js +420 -0
data/lib/tina4/public/js/tina4-dev-admin.min.js +367 -0
data/lib/tina4/public/js/tina4.min.js +93 -0
data/lib/tina4/public/swagger/index.html +90 -0
data/lib/tina4/public/swagger/oauth2-redirect.html +63 -0
data/lib/tina4/queue.rb +40 -4
data/lib/tina4/queue_backends/lite_backend.rb +88 -0
data/lib/tina4/rack_app.rb +314 -23
data/lib/tina4/rate_limiter.rb +123 -0
data/lib/tina4/request.rb +61 -15
data/lib/tina4/response.rb +54 -24
data/lib/tina4/response_cache.rb +134 -0
data/lib/tina4/router.rb +90 -15
data/lib/tina4/scss_compiler.rb +2 -2
data/lib/tina4/seeder.rb +56 -61
data/lib/tina4/service_runner.rb +303 -0
data/lib/tina4/session.rb +85 -0
data/lib/tina4/session_handlers/mongo_handler.rb +1 -1
data/lib/tina4/session_handlers/valkey_handler.rb +43 -0
data/lib/tina4/shutdown.rb +84 -0
data/lib/tina4/sql_translation.rb +295 -0
data/lib/tina4/template.rb +36 -6
data/lib/tina4/templates/base.twig +2 -2
data/lib/tina4/templates/errors/302.twig +14 -0
data/lib/tina4/templates/errors/401.twig +9 -0
data/lib/tina4/templates/errors/403.twig +22 -15
data/lib/tina4/templates/errors/404.twig +22 -15
data/lib/tina4/templates/errors/500.twig +31 -15
data/lib/tina4/templates/errors/502.twig +9 -0
data/lib/tina4/templates/errors/503.twig +12 -0
data/lib/tina4/templates/errors/base.twig +37 -0
data/lib/tina4/version.rb +1 -1
data/lib/tina4/webserver.rb +28 -18
data/lib/tina4.rb +57 -21
metadata +51 -19
data/lib/tina4/public/js/tina4.js +0 -134
data/lib/tina4/public/js/tina4helper.js +0 -387

data/lib/tina4/gallery/auth/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Auth", "description": "JWT login form with token display", "try_url": "/gallery/auth"}

data/lib/tina4/gallery/auth/src/routes/api/gallery_auth.rb ADDED Viewed

@@ -0,0 +1,114 @@
+# Gallery: Auth — JWT login with a visual demo page.
+Tina4::Router.get("/gallery/auth") do |request, response|
+  html = <<~HTML
+    <!DOCTYPE html>
+    <html lang="en">
+    <head>
+    <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>Auth Demo</title><link rel="stylesheet" href="/css/tina4.min.css">
+    </head>
+    <body class="bg-dark text-light">
+    <div class="container mt-5" style="max-width:600px;">
+        <h2 class="mb-4">JWT Authentication Demo</h2>
+        <div class="card mb-4">
+            <div class="card-header bg-primary text-white">Login</div>
+            <div class="card-body">
+                <div class="form-group mb-3">
+                    <label class="form-label">Username</label>
+                    <input type="text" id="username" class="form-control" placeholder="admin" value="admin">
+                </div>
+                <div class="form-group mb-3">
+                    <label class="form-label">Password</label>
+                    <input type="password" id="password" class="form-control" placeholder="secret" value="secret">
+                </div>
+                <button class="btn btn-primary" onclick="doLogin()">Login</button>
+            </div>
+        </div>
+        <div id="result" style="display:none;">
+            <div class="card mb-3">
+                <div class="card-header bg-success text-white">Token Received</div>
+                <div class="card-body">
+                    <pre id="token" style="word-break:break-all;white-space:pre-wrap;color:#4ade80;background:#1e293b;padding:1rem;border-radius:0.5rem;"></pre>
+                </div>
+            </div>
+            <div class="card mb-3">
+                <div class="card-header">Token Payload (decoded)</div>
+                <div class="card-body">
+                    <pre id="payload" style="color:#38bdf8;background:#1e293b;padding:1rem;border-radius:0.5rem;"></pre>
+                </div>
+            </div>
+            <button class="btn btn-outline-info" onclick="verifyToken()">Verify Token</button>
+            <span id="verify-result" class="ms-2"></span>
+        </div>
+        <div class="card bg-dark mt-4" style="border:1px solid #334155;">
+            <div class="card-body">
+                <h6 style="color:#e2e8f0;">How it works</h6>
+                <pre style="background:#0f172a;color:#4ade80;padding:1rem;border-radius:0.5rem;font-size:0.8rem;"><code>token = Tina4::Auth.create_token({ username: "admin" })
+    payload = Tina4::Auth.get_payload(token)
+    result = Tina4::Auth.validate_token(token)</code></pre>
+            </div>
+        </div>
+    </div>
+    <script>
+    var currentToken = '';
+    function doLogin() {
+        fetch('/api/gallery/auth/login', {
+            method: 'POST',
+            headers: {'Content-Type': 'application/json'},
+            body: JSON.stringify({
+                username: document.getElementById('username').value,
+                password: document.getElementById('password').value
+            })
+        }).then(r => r.json()).then(d => {
+            if (d.token) {
+                currentToken = d.token;
+                document.getElementById('token').textContent = d.token;
+                try {
+                    var parts = d.token.split('.');
+                    var payload = JSON.parse(atob(parts[1]));
+                    document.getElementById('payload').textContent = JSON.stringify(payload, null, 2);
+                } catch(e) {
+                    document.getElementById('payload').textContent = 'Could not decode';
+                }
+                document.getElementById('result').style.display = 'block';
+                document.getElementById('verify-result').textContent = '';
+            } else {
+                alert(d.error || 'Login failed');
+            }
+        });
+    }
+    function verifyToken() {
+        fetch('/api/gallery/auth/verify?token=' + encodeURIComponent(currentToken))
+        .then(r => r.json()).then(d => {
+            var el = document.getElementById('verify-result');
+            if (d.valid) {
+                el.innerHTML = '<span class="badge bg-success">Valid</span>';
+            } else {
+                el.innerHTML = '<span class="badge bg-danger">Invalid</span>';
+            }
+        });
+    }
+    </script>
+    </body></html>
+  HTML
+  response.html(html)
+end
+Tina4::Router.post("/api/gallery/auth/login") do |request, response|
+  body = request.body || {}
+  username = body["username"].to_s
+  password = body["password"].to_s
+  if !username.empty? && !password.empty?
+    token = Tina4::Auth.create_token({ username: username, role: "user" })
+    response.json({ token: token, message: "Welcome #{username}!" })
+  else
+    response.json({ error: "Username and password required" }, 401)
+  end
+end
+Tina4::Router.get("/api/gallery/auth/verify") do |request, response|
+  token = request.params["token"].to_s
+  result = Tina4::Auth.validate_token(token)
+  response.json({ valid: result[:valid] })
+end

data/lib/tina4/gallery/database/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Database", "description": "Raw SQL queries with the Database class", "try_url": "/api/gallery/db/tables"}

data/lib/tina4/gallery/database/src/routes/api/gallery_db.rb ADDED Viewed

@@ -0,0 +1,43 @@
+# Gallery: Database — raw SQL query demo.
+Tina4::Router.get("/api/gallery/db/tables") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    db.execute(<<~SQL)
+      CREATE TABLE IF NOT EXISTS gallery_notes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        title TEXT NOT NULL,
+        body TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )
+    SQL
+    tables = db.tables
+    response.json({ tables: tables, engine: "sqlite" })
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end
+Tina4::Router.post("/api/gallery/db/notes") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    body = request.body || {}
+    db.insert("gallery_notes", {
+      title: body["title"] || "Untitled",
+      body: body["body"] || ""
+    })
+    response.json({ created: true }, 201)
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end
+Tina4::Router.get("/api/gallery/db/notes") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    result = db.fetch("SELECT * FROM gallery_notes ORDER BY id DESC", [], limit: 50)
+    response.json(result.to_a)
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end

data/lib/tina4/gallery/error-overlay/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Error Overlay", "description": "See the rich debug error page with stack trace and source code", "try_url": "/api/gallery/crash"}

data/lib/tina4/gallery/error-overlay/src/routes/api/gallery_crash.rb ADDED Viewed

@@ -0,0 +1,17 @@
+# Gallery: Error Overlay — deliberately crash to demo the debug overlay.
+#
+# This route deliberately raises an error to showcase the error overlay.
+#
+# In debug mode (TINA4_DEBUG=true), you will see:
+# - Exception type and message
+# - Stack trace with syntax-highlighted source code
+# - The exact line that caused the error (highlighted)
+# - Request details (method, path, headers)
+# - Environment info (framework version, Ruby version)
+Tina4::Router.get("/api/gallery/crash") do |request, response|
+  # Simulate a realistic error — accessing a missing key
+  user = { name: "Alice", email: "alice@example.com" }
+  role = user.fetch(:role) # KeyError: key not found: :role — this line will be highlighted in the overlay
+  response.json({ role: role })
+end

data/lib/tina4/gallery/orm/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "ORM", "description": "Product model with CRUD endpoints", "try_url": "/api/gallery/products"}

data/lib/tina4/gallery/orm/src/routes/api/gallery_products.rb ADDED Viewed

@@ -0,0 +1,16 @@
+# Gallery: ORM — Product CRUD endpoints.
+Tina4::Router.get("/api/gallery/products") do |request, response|
+  response.json({
+    products: [
+      { id: 1, name: "Widget", price: 9.99 },
+      { id: 2, name: "Gadget", price: 24.99 }
+    ],
+    note: "Connect a database and deploy the ORM model for live data"
+  })
+end
+Tina4::Router.post("/api/gallery/products") do |request, response|
+  data = request.body || {}
+  response.json({ created: data, id: 3 }, 201)
+end

data/lib/tina4/gallery/queue/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Queue", "description": "Background job producer and consumer", "try_url": "/api/gallery/queue/produce"}

data/lib/tina4/gallery/queue/src/routes/api/gallery_queue.rb ADDED Viewed

@@ -0,0 +1,27 @@
+# Gallery: Queue — produce and consume background jobs.
+Tina4::Router.post("/api/gallery/queue/produce") do |request, response|
+  body = request.body || {}
+  task = body["task"] || "default-task"
+  data = body["data"] || {}
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery_queue.db")
+    queue = Tina4::Queue.new(db, topic: "gallery-tasks")
+    producer = Tina4::Producer.new(queue)
+    producer.produce({ task: task, data: data })
+    response.json({ queued: true, task: task }, 201)
+  rescue => e
+    response.json({ queued: true, task: task, note: "Queue demo (#{e.message})" }, 201)
+  end
+end
+Tina4::Router.get("/api/gallery/queue/status") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery_queue.db")
+    queue = Tina4::Queue.new(db, topic: "gallery-tasks")
+    response.json({ topic: "gallery-tasks", size: queue.size })
+  rescue => e
+    response.json({ topic: "gallery-tasks", size: 0, note: "Queue demo (#{e.message})" })
+  end
+end

data/lib/tina4/gallery/rest-api/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "REST API", "description": "A simple JSON API with GET and POST endpoints", "try_url": "/api/gallery/hello"}

data/lib/tina4/gallery/rest-api/src/routes/api/gallery_hello.rb ADDED Viewed

@@ -0,0 +1,14 @@
+# Gallery: REST API — simple JSON endpoints.
+Tina4::Router.get("/api/gallery/hello") do |request, response|
+  response.json({ message: "Hello from Tina4!", method: "GET" })
+end
+Tina4::Router.get("/api/gallery/hello/{name}") do |request, response|
+  response.json({ message: "Hello #{request.params["name"]}!", method: "GET" })
+end
+Tina4::Router.post("/api/gallery/hello") do |request, response|
+  data = request.body || {}
+  response.json({ echo: data, method: "POST" }, 201)
+end

data/lib/tina4/gallery/templates/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Templates", "description": "Twig template with dynamic data", "try_url": "/gallery/page"}

data/lib/tina4/gallery/templates/src/routes/gallery_page.rb ADDED Viewed

@@ -0,0 +1,12 @@
+# Gallery: Templates — render an HTML page with dynamic data via template.
+Tina4::Router.get "/gallery/page", template: "gallery_page.twig" do |request, response|
+  response.call({
+    title: "Gallery Demo Page",
+    items: [
+      { name: "Tina4 Ruby", description: "Zero-dep web framework", badge: "v3.0.0" },
+      { name: "Twig Engine", description: "Built-in template rendering", badge: "included" },
+      { name: "Auto-Reload", description: "Templates refresh on save", badge: "dev mode" }
+    ]
+  }, Tina4::HTTP_OK)
+end

data/lib/tina4/gallery/templates/src/templates/gallery_page.twig ADDED Viewed

@@ -0,0 +1,257 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{ title }}</title>
+    <link rel="stylesheet" href="/css/tina4.min.css">
+    <style>
+        .component-section { margin-bottom: 2.5rem; }
+        .component-section h3 { border-bottom: 2px solid var(--bs-primary, #0d6efd); padding-bottom: 0.5rem; margin-bottom: 1rem; }
+        .code-preview { background: #1e293b; color: #4ade80; padding: 1rem; border-radius: 0.5rem; font-family: monospace; font-size: 0.85rem; overflow-x: auto; margin-top: 0.75rem; }
+    </style>
+</head>
+<body>
+<!-- Navbar -->
+<nav class="navbar navbar-dark bg-dark navbar-expand-lg">
+    <div class="container">
+        <a class="navbar-brand" href="/">Tina4 CSS Showcase</a>
+        <div class="navbar-nav ms-auto">
+            <a class="nav-link active" href="#">Components</a>
+            <a class="nav-link" href="/__dev">Dashboard</a>
+            <a class="nav-link" href="/swagger">API Docs</a>
+        </div>
+    </div>
+</nav>
+<div class="container mt-4">
+    <div class="alert alert-info alert-dismissible mb-4">
+        <strong>tina4css</strong> — Zero-dependency CSS framework (~24KB). Bootstrap-compatible class names, dark mode ready. No CDN needed — ships with every Tina4 project.
+        <button type="button" class="btn-close" onclick="this.parentElement.remove()"></button>
+    </div>
+    <!-- Buttons -->
+    <div class="component-section">
+        <h3>Buttons</h3>
+        <div class="d-flex flex-wrap gap-2 mb-3">
+            <button class="btn btn-primary">Primary</button>
+            <button class="btn btn-secondary">Secondary</button>
+            <button class="btn btn-success">Success</button>
+            <button class="btn btn-danger">Danger</button>
+            <button class="btn btn-warning">Warning</button>
+            <button class="btn btn-info">Info</button>
+            <button class="btn btn-dark">Dark</button>
+            <button class="btn btn-light">Light</button>
+        </div>
+        <div class="d-flex flex-wrap gap-2 mb-3">
+            <button class="btn btn-outline-primary">Outline</button>
+            <button class="btn btn-outline-success">Outline</button>
+            <button class="btn btn-outline-danger">Outline</button>
+            <button class="btn btn-outline-warning">Outline</button>
+        </div>
+        <div class="d-flex flex-wrap gap-2">
+            <button class="btn btn-primary btn-lg">Large</button>
+            <button class="btn btn-primary">Default</button>
+            <button class="btn btn-primary btn-sm">Small</button>
+        </div>
+    </div>
+    <!-- Alerts -->
+    <div class="component-section">
+        <h3>Alerts</h3>
+        <div class="alert alert-success">Success — Record saved successfully!</div>
+        <div class="alert alert-danger">Error — Something went wrong.</div>
+        <div class="alert alert-warning">Warning — Please check your input.</div>
+        <div class="alert alert-info">Info — New version available.</div>
+    </div>
+    <!-- Cards -->
+    <div class="component-section">
+        <h3>Cards</h3>
+        <div class="row">
+            {% for item in items %}
+            <div class="col-md-4 mb-3">
+                <div class="card h-100">
+                    <div class="card-header bg-primary text-white">{{ item.name }}</div>
+                    <div class="card-body">
+                        <p class="card-text">{{ item.description }}</p>
+                        <span class="badge bg-success">{{ item.badge }}</span>
+                    </div>
+                    <div class="card-footer text-muted">
+                        <small>Built with tina4css</small>
+                    </div>
+                </div>
+            </div>
+            {% endfor %}
+        </div>
+    </div>
+    <!-- Badges -->
+    <div class="component-section">
+        <h3>Badges</h3>
+        <span class="badge bg-primary me-1">Primary</span>
+        <span class="badge bg-secondary me-1">Secondary</span>
+        <span class="badge bg-success me-1">Success</span>
+        <span class="badge bg-danger me-1">Danger</span>
+        <span class="badge bg-warning me-1">Warning</span>
+        <span class="badge bg-info me-1">Info</span>
+        <span class="badge bg-dark me-1">Dark</span>
+    </div>
+    <!-- Forms -->
+    <div class="component-section">
+        <h3>Forms</h3>
+        <div class="card">
+            <div class="card-body">
+                <form>
+                    <div class="row mb-3">
+                        <div class="col-md-6">
+                            <div class="form-group">
+                                <label class="form-label">Full Name</label>
+                                <input type="text" class="form-control" placeholder="Andre van Zuydam">
+                            </div>
+                        </div>
+                        <div class="col-md-6">
+                            <div class="form-group">
+                                <label class="form-label">Email</label>
+                                <input type="email" class="form-control" placeholder="you@example.com">
+                            </div>
+                        </div>
+                    </div>
+                    <div class="row mb-3">
+                        <div class="col-md-6">
+                            <div class="form-group">
+                                <label class="form-label">Framework</label>
+                                <select class="form-select">
+                                    <option>Python</option>
+                                    <option>PHP</option>
+                                    <option selected>Ruby</option>
+                                    <option>Node.js</option>
+                                </select>
+                            </div>
+                        </div>
+                        <div class="col-md-6">
+                            <div class="form-group">
+                                <label class="form-label">Database</label>
+                                <select class="form-select">
+                                    <option>SQLite</option>
+                                    <option>PostgreSQL</option>
+                                    <option>MySQL</option>
+                                    <option>Firebird</option>
+                                    <option>MSSQL</option>
+                                </select>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="form-group mb-3">
+                        <label class="form-label">Message</label>
+                        <textarea class="form-control" rows="3" placeholder="Tell us about your project..."></textarea>
+                    </div>
+                    <div class="form-check mb-3">
+                        <input class="form-check-input" type="checkbox" checked>
+                        <label class="form-check-label">I agree to the terms</label>
+                    </div>
+                    <button type="button" class="btn btn-primary">Submit</button>
+                    <button type="button" class="btn btn-outline-secondary ms-2">Cancel</button>
+                </form>
+            </div>
+        </div>
+    </div>
+    <!-- Table -->
+    <div class="component-section">
+        <h3>Tables</h3>
+        <div class="table-responsive">
+            <table class="table table-striped table-hover">
+                <thead>
+                    <tr>
+                        <th>#</th>
+                        <th>Framework</th>
+                        <th>Port</th>
+                        <th>Language</th>
+                        <th>Status</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    <tr><td>1</td><td>tina4-python</td><td>7145</td><td>Python 3.12+</td><td><span class="badge bg-success">Stable</span></td></tr>
+                    <tr><td>2</td><td>tina4-php</td><td>7146</td><td>PHP 8.2+</td><td><span class="badge bg-success">Stable</span></td></tr>
+                    <tr><td>3</td><td>tina4-ruby</td><td>7147</td><td>Ruby 3.1+</td><td><span class="badge bg-success">Stable</span></td></tr>
+                    <tr><td>4</td><td>tina4-nodejs</td><td>7148</td><td>Node 20+</td><td><span class="badge bg-success">Stable</span></td></tr>
+                </tbody>
+            </table>
+        </div>
+    </div>
+    <!-- Breadcrumbs -->
+    <div class="component-section">
+        <h3>Breadcrumbs</h3>
+        <nav>
+            <ol class="breadcrumb">
+                <li class="breadcrumb-item"><a href="/">Home</a></li>
+                <li class="breadcrumb-item"><a href="#">Gallery</a></li>
+                <li class="breadcrumb-item active">Components</li>
+            </ol>
+        </nav>
+    </div>
+    <!-- Input Groups -->
+    <div class="component-section">
+        <h3>Input Groups</h3>
+        <div class="input-group mb-3">
+            <span class="input-group-text">@</span>
+            <input type="text" class="form-control" placeholder="Username">
+        </div>
+        <div class="input-group mb-3">
+            <input type="text" class="form-control" placeholder="Search routes...">
+            <button class="btn btn-primary">Search</button>
+        </div>
+        <div class="input-group">
+            <span class="input-group-text">https://</span>
+            <input type="text" class="form-control" placeholder="tina4.com">
+            <span class="input-group-text">/api</span>
+        </div>
+    </div>
+    <!-- Progress -->
+    <div class="component-section">
+        <h3>Progress Bars</h3>
+        <div class="progress mb-2"><div class="progress-bar bg-primary" style="width: 25%">25%</div></div>
+        <div class="progress mb-2"><div class="progress-bar bg-success" style="width: 50%">50%</div></div>
+        <div class="progress mb-2"><div class="progress-bar bg-warning" style="width: 75%">75%</div></div>
+        <div class="progress"><div class="progress-bar bg-danger" style="width: 100%">100%</div></div>
+    </div>
+    <!-- List Group -->
+    <div class="component-section">
+        <h3>List Group</h3>
+        <div class="list-group">
+            <a href="#" class="list-group-item list-group-item-action active">Routes — 12 registered</a>
+            <a href="#" class="list-group-item list-group-item-action">Queue — 3 pending jobs</a>
+            <a href="#" class="list-group-item list-group-item-action">Database — SQLite connected</a>
+            <a href="#" class="list-group-item list-group-item-action disabled">Cache — Not configured</a>
+        </div>
+    </div>
+    <!-- How this page was built -->
+    <div class="card mt-4 mb-5" style="background:#0f172a;border:1px solid #334155;">
+        <div class="card-body">
+            <h5 style="color:#e2e8f0;">How this page was built</h5>
+            <pre style="background:#1e293b;border:1px solid #334155;border-radius:0.5rem;padding:1.25rem;margin-top:0.75rem;overflow-x:auto;font-family:'SF Mono',SFMono-Regular,Consolas,monospace;font-size:0.9rem;line-height:1.7;"><code><span style="color:#c084fc;">Tina4::Router.get</span> <span style="color:#4ade80;">"/gallery/page"</span>, <span style="color:#38bdf8;">template:</span> <span style="color:#4ade80;">"gallery_page.twig"</span> <span style="color:#c084fc;">do</span> |request, response|
+  response.call({
+    <span style="color:#fbbf24;">title:</span> <span style="color:#4ade80;">"tina4css Component Showcase"</span>,
+    <span style="color:#fbbf24;">items:</span> [...]
+  }, Tina4::HTTP_OK)
+<span style="color:#c084fc;">end</span></code></pre>
+            <p style="color:#94a3b8;margin-top:0.75rem;margin-bottom:0;">
+                Rendered via <code style="color:#c084fc;">template:</code> keyword. Styled with <strong style="color:#e2e8f0;">tina4css</strong> — zero external CDN.
+                All components above use only <code style="color:#4ade80;">&lt;link href="/css/tina4.min.css"&gt;</code>.
+            </p>
+        </div>
+    </div>
+</div>
+</body>
+</html>

data/lib/tina4/health.rb ADDED Viewed

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+require "json"
+module Tina4
+  module Health
+    START_TIME = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    class << self
+      def register!
+        Tina4::Router.add_route("GET", "/health", method(:handle))
+      end
+      def handle(_request, response)
+        now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        uptime = (now - START_TIME).round(2)
+        payload = {
+          status: "ok",
+          version: Tina4::VERSION,
+          uptime: uptime,
+          framework: "tina4-ruby"
+        }
+        response.json(payload)
+      end
+      def status
+        now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        {
+          status: "ok",
+          version: Tina4::VERSION,
+          uptime: (now - START_TIME).round(2),
+          framework: "tina4-ruby"
+        }
+      end
+    end
+  end
+end