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

tina4ruby 0.5.2 → 3.2.1

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 +434 -544
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 +389 -97
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 +144 -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 +1497 -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 +325 -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 +562 -0
data/lib/tina4/migration.rb +132 -29
data/lib/tina4/orm.rb +463 -35
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 +162 -6
data/lib/tina4/queue_backends/lite_backend.rb +88 -0
data/lib/tina4/rack_app.rb +331 -27
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 +551 -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 +118 -21
metadata +68 -8
data/lib/tina4/public/js/tina4.js +0 -134
data/lib/tina4/public/js/tina4helper.js +0 -387

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

data/lib/tina4/html_element.rb ADDED Viewed

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+module Tina4
+  # Programmatic HTML builder — avoids string concatenation.
+  #
+  # Usage:
+  #   el = Tina4::HtmlElement.new("div", { class: "card" }, ["Hello"])
+  #   el.to_s  # => '<div class="card">Hello</div>'
+  #
+  #   # Builder pattern (via call)
+  #   el = Tina4::HtmlElement.new("div").call(Tina4::HtmlElement.new("p").call("Text"))
+  #
+  #   # Helper functions
+  #   include Tina4::HtmlHelpers
+  #   html = _div({ class: "card" }, _p("Hello"))
+  #
+  class HtmlElement
+    VOID_TAGS = %w[
+      area base br col embed hr img input
+      link meta param source track wbr
+    ].freeze
+    HTML_TAGS = %w[
+      a abbr address area article aside audio
+      b base bdi bdo blockquote body br button
+      canvas caption cite code col colgroup
+      data datalist dd del details dfn dialog div dl dt
+      em embed
+      fieldset figcaption figure footer form
+      h1 h2 h3 h4 h5 h6 head header hgroup hr html
+      i iframe img input ins
+      kbd
+      label legend li link
+      main map mark menu meta meter
+      nav noscript
+      object ol optgroup option output
+      p param picture pre progress
+      q
+      rp rt ruby
+      s samp script section select slot small source span
+      strong style sub summary sup
+      table tbody td template textarea tfoot th thead time
+      title tr track
+      u ul
+      var video
+      wbr
+    ].freeze
+    attr_reader :tag, :attrs, :children
+    # @param tag      [String] HTML tag name
+    # @param attrs    [Hash]   attribute => value
+    # @param children [Array]  child elements (strings or HtmlElement instances)
+    def initialize(tag, attrs = {}, children = [])
+      @tag = tag.to_s.downcase
+      @attrs = attrs
+      @children = children
+    end
+    # Builder pattern — appends children and/or merges attributes.
+    #
+    # @param args [Array] Strings, HtmlElements, Hashes (treated as attrs), or Arrays
+    # @return [HtmlElement] a new HtmlElement with the appended children
+    def call(*args)
+      new_attrs = @attrs.dup
+      new_children = @children.dup
+      args.each do |arg|
+        case arg
+        when Hash
+          new_attrs = new_attrs.merge(arg)
+        when Array
+          new_children.concat(arg)
+        else
+          new_children << arg
+        end
+      end
+      self.class.new(@tag, new_attrs, new_children)
+    end
+    # Render to HTML string.
+    def to_s
+      html = "<#{@tag}"
+      @attrs.each do |key, value|
+        case value
+        when true
+          html << " #{key}"
+        when false, nil
+          next
+        else
+          escaped = value.to_s
+            .gsub("&", "&amp;")
+            .gsub('"', "&quot;")
+            .gsub("<", "&lt;")
+            .gsub(">", "&gt;")
+          html << " #{key}=\"#{escaped}\""
+        end
+      end
+      if VOID_TAGS.include?(@tag)
+        html << ">"
+        return html
+      end
+      html << ">"
+      @children.each do |child|
+        html << child.to_s
+      end
+      html << "</#{@tag}>"
+      html
+    end
+  end
+  # Module providing _div, _p, _span, etc. helper methods.
+  # Include in any class or use extend on a module.
+  module HtmlHelpers
+    HtmlElement::HTML_TAGS.each do |tag|
+      define_method("_#{tag}") do |*args|
+        attrs = {}
+        children = []
+        args.each do |arg|
+          case arg
+          when Hash
+            attrs = attrs.merge(arg)
+          when Array
+            children.concat(arg)
+          when HtmlElement
+            children << arg
+          else
+            children << arg
+          end
+        end
+        HtmlElement.new(tag, attrs, children)
+      end
+    end
+  end
+  # Module-level convenience: Tina4.html_helpers returns a module you can include.
+  def self.html_helpers
+    HtmlHelpers
+  end
+end

data/lib/tina4/localization.rb CHANGED Viewed

@@ -28,7 +28,7 @@ module Tina4
             data = JSON.parse(File.read(file))
             translations[locale] ||= {}
             translations[locale].merge!(data)
-            Tina4::Debug.debug("Loaded locale: #{locale} from #{file}")
+            Tina4::Log.debug("Loaded locale: #{locale} from #{file}")
           end
           # Also support YAML
@@ -40,7 +40,7 @@ module Tina4
               translations[locale] ||= {}
               translations[locale].merge!(data) if data.is_a?(Hash)
             rescue LoadError
-              Tina4::Debug.warning("YAML support requires the 'yaml' gem")
+              Tina4::Log.warning("YAML support requires the 'yaml' gem")
             end
           end
         end

data/lib/tina4/log.rb ADDED Viewed

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+require "fileutils"
+require "json"
+module Tina4
+  module Log
+    LEVELS = {
+      "[TINA4_LOG_ALL]" => 0,
+      "[TINA4_LOG_DEBUG]" => 0,
+      "[TINA4_LOG_INFO]" => 1,
+      "[TINA4_LOG_WARNING]" => 2,
+      "[TINA4_LOG_ERROR]" => 3,
+      "[TINA4_LOG_NONE]" => 4
+    }.freeze
+    SEVERITY_MAP = {
+      debug: 0, info: 1, warn: 2, error: 3
+    }.freeze
+    COLORS = {
+      reset: "\e[0m", red: "\e[31m", green: "\e[32m",
+      yellow: "\e[33m", blue: "\e[34m", magenta: "\e[35m",
+      cyan: "\e[36m", gray: "\e[90m"
+    }.freeze
+    # ANSI escape code regex for stripping from file output
+    ANSI_RE = /\033\[[0-9;]*m/
+    class << self
+      attr_reader :log_dir
+      def setup(root_dir = Dir.pwd)
+        @log_dir = File.join(root_dir, "logs")
+        FileUtils.mkdir_p(@log_dir)
+        @max_size_mb = (ENV["TINA4_LOG_MAX_SIZE"] || "10").to_i
+        @max_size = @max_size_mb * 1024 * 1024
+        @keep = (ENV["TINA4_LOG_KEEP"] || "5").to_i
+        @json_mode = production?
+        @log_file = File.join(@log_dir, "tina4.log")
+        @console_level = resolve_level
+        @request_id = nil
+        @current_context = {}
+        @mutex = Mutex.new
+        @initialized = true
+      end
+      def set_request_id(id)
+        @mutex.synchronize { @request_id = id }
+      end
+      def clear_request_id
+        @mutex.synchronize { @request_id = nil }
+      end
+      def request_id
+        @mutex.synchronize { @request_id }
+      end
+      def json_mode?
+        @json_mode
+      end
+      def info(message, context = {})
+        log(:info, message, context)
+      end
+      def debug(message, context = {})
+        log(:debug, message, context)
+      end
+      def warning(message, context = {})
+        log(:warn, message, context)
+      end
+      def error(message, context = {})
+        log(:error, message, context)
+      end
+      private
+      def production?
+        env = ENV["TINA4_ENV"] || ENV["RACK_ENV"] || ENV["RUBY_ENV"] || "development"
+        env.downcase == "production"
+      end
+      def log(level, message, context = {})
+        setup unless @initialized
+        @current_context = context.is_a?(Hash) ? context : {}
+        formatted = format_line(level, message)
+        # Console output respects TINA4_LOG_LEVEL
+        severity = SEVERITY_MAP[level] || 0
+        if severity >= @console_level
+          if @json_mode
+            $stdout.puts json_line(level, message)
+          else
+            $stdout.puts colorize(level, formatted)
+          end
+        end
+        # File always gets ALL levels, plain text (no ANSI)
+        write_to_file(strip_ansi(formatted))
+        @current_context = {}
+      end
+      def resolve_level
+        env_level = ENV["TINA4_LOG_LEVEL"] || "[TINA4_LOG_ALL]"
+        LEVELS[env_level] || 0
+      end
+      def severity_to_level(level)
+        case level
+        when :debug then "DEBUG"
+        when :info  then "INFO"
+        when :warn  then "WARNING"
+        when :error then "ERROR"
+        else level.to_s.upcase
+        end
+      end
+      def utc_timestamp
+        now = Time.now.utc
+        now.strftime("%Y-%m-%dT%H:%M:%S.") + format("%03d", now.usec / 1000) + "Z"
+      end
+      def strip_ansi(text)
+        text.gsub(ANSI_RE, "")
+      end
+      def format_line(level, message)
+        level_str = severity_to_level(level)
+        ts = utc_timestamp
+        rid = request_id
+        rid_str = rid ? " [#{rid}]" : ""
+        ctx = @current_context && !@current_context.empty? ? " #{JSON.generate(@current_context)}" : ""
+        "#{ts} [#{level_str.ljust(7)}]#{rid_str} #{message}#{ctx}"
+      end
+      def json_line(level, message)
+        level_str = severity_to_level(level)
+        entry = {
+          timestamp: utc_timestamp,
+          level: level_str,
+          message: message
+        }
+        rid = request_id
+        entry[:request_id] = rid if rid
+        entry[:context] = @current_context if @current_context && !@current_context.empty?
+        JSON.generate(entry)
+      end
+      def colorize(level, line)
+        color = case level
+                when :debug   then COLORS[:cyan]
+                when :info    then COLORS[:green]
+                when :warn    then COLORS[:yellow]
+                when :error   then COLORS[:red]
+                else COLORS[:reset]
+                end
+        "#{color}#{line}#{COLORS[:reset]}"
+      end
+      def write_to_file(line)
+        rotate_if_needed
+        begin
+          File.open(@log_file, "a") { |f| f.puts(line) }
+        rescue IOError, SystemCallError
+          # Don't crash on log write failure
+        end
+      end
+      # Numbered rotation: tina4.log → tina4.log.1 → tina4.log.2 → ... → tina4.log.{keep}
+      def rotate_if_needed
+        return unless File.exist?(@log_file)
+        begin
+          return if File.size(@log_file) < @max_size
+        rescue SystemCallError
+          return
+        end
+        # Delete the oldest rotated file if it exists
+        oldest = "#{@log_file}.#{@keep}"
+        File.delete(oldest) if File.exist?(oldest)
+        # Shift existing rotated files: .{n} → .{n+1}
+        (@keep - 1).downto(1) do |n|
+          src = "#{@log_file}.#{n}"
+          dst = "#{@log_file}.#{n + 1}"
+          File.rename(src, dst) if File.exist?(src)
+        end
+        # Rename current log to .1
+        File.rename(@log_file, "#{@log_file}.1") rescue nil
+      end
+    end
+  end
+end