tina4ruby 3.11.17 → 3.11.19

data/lib/tina4/rack_app.rb

@@ -714,10 +714,55 @@ module Tina4
             <span style="color:#ffeb3b;">req:#{request_id}</span>
             <span style="color:#90caf9;">#{route_count} routes</span>
             <span style="color:#888;">Ruby #{RUBY_VERSION}</span>
-            <a href="#" onclick="(function(e){e.preventDefault();var p=document.getElementById('tina4-dev-panel');if(p){p.style.display=p.style.display==='none'?'block':'none';return;}var c=document.createElement('div');c.id='tina4-dev-panel';c.style.cssText='position:fixed;top:3rem;left:0;right:0;bottom:2rem;z-index:99998;transition:all 0.2s';var f=document.createElement('iframe');f.src='/__dev';f.style.cssText='width:100%;height:100%;border:1px solid #CC342D;border-radius:0.5rem;box-shadow:0 8px 32px rgba(0,0,0,0.5);background:#0f172a';c.appendChild(f);document.body.appendChild(c);})(event)" style="color:#ef9a9a;margin-left:auto;text-decoration:none;cursor:pointer;">Dashboard &#8599;</a>
+            <a href="#" onclick="window.__tina4ToggleOverlay(event)" style="color:#ef9a9a;margin-left:auto;text-decoration:none;cursor:pointer;">Dashboard &#8599;</a>
             <span onclick="this.parentElement.style.display='none'" style="cursor:pointer;color:#888;margin-left:8px;">&#10005;</span>
         </div>
         <script>
+        // Overlay open/toggle helper + auto-restore. Persist the dev-admin
+        // iframe's open/closed state across parent reloads so saving a
+        // file doesn't lose the user's dev-admin context. Cross-framework
+        // parity with PHP / Python / Node — same localStorage key.
+        (function(){
+            var STATE_KEY = 'tina4_dev_overlay_open';
+            function buildOverlay() {
+                var c = document.createElement('div');
+                c.id = 'tina4-dev-panel';
+                c.style.cssText = 'position:fixed;top:3rem;left:0;right:0;bottom:2rem;z-index:99998;transition:all 0.2s';
+                var f = document.createElement('iframe');
+                f.src = '/__dev';
+                f.style.cssText = 'width:100%;height:100%;border:1px solid #CC342D;border-radius:0.5rem;box-shadow:0 8px 32px rgba(0,0,0,0.5);background:#0f172a';
+                c.appendChild(f);
+                document.body.appendChild(c);
+                return c;
+            }
+            window.__tina4ToggleOverlay = function(e) {
+                if (e) e.preventDefault();
+                var p = document.getElementById('tina4-dev-panel');
+                if (p) {
+                    var hide = p.style.display !== 'none';
+                    p.style.display = hide ? 'none' : 'block';
+                    try { localStorage.setItem(STATE_KEY, hide ? '0' : '1'); } catch (_) {}
+                    return;
+                }
+                buildOverlay();
+                try { localStorage.setItem(STATE_KEY, '1'); } catch (_) {}
+            };
+            function restoreIfOpen() {
+                try {
+                    if (location.pathname.indexOf('/__dev') === 0) return;
+                    if (localStorage.getItem(STATE_KEY) === '1' && !document.getElementById('tina4-dev-panel')) {
+                        buildOverlay();
+                    }
+                } catch (_) {}
+            }
+            if (document.readyState === 'loading') {
+                document.addEventListener('DOMContentLoaded', restoreIfOpen);
+            } else {
+                restoreIfOpen();
+            }
+        })();
+        </script>
+        <script>
         function tina4VersionModal(){
             var m=document.getElementById('tina4-ver-modal');
             if(m.style.display==='block'){m.style.display='none';return;}

data/lib/tina4/response.rb

@@ -151,6 +151,9 @@ module Tina4
       self
     end
 
+    # Render a Frond/Twig template file with data and return self. Tries
+    # the user template directory first, falling back to the framework's
+    # built-in templates. Sets the response body to the rendered HTML.
     def render(template_path, data = {}, status: 200, template_dir: nil)
       @status_code = status
       @headers["content-type"] = HTML_CONTENT_TYPE

data/lib/tina4/shutdown.rb

@@ -53,6 +53,16 @@ module Tina4
           end
         end
 
+        # Stop background tasks
+        if defined?(Tina4::Background)
+          begin
+            Tina4::Background.stop_all
+            Tina4::Log.info("Background tasks stopped")
+          rescue => e
+            Tina4::Log.error("Error stopping background tasks: #{e.message}")
+          end
+        end
+
         # Close database connections
         if Tina4.database
           begin

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.11.17"
+  VERSION = "3.11.19"
 end

data/lib/tina4.rb

@@ -35,6 +35,7 @@ require_relative "tina4/cors"
 require_relative "tina4/rate_limiter"
 require_relative "tina4/health"
 require_relative "tina4/shutdown"
+require_relative "tina4/background"
 require_relative "tina4/localization"
 require_relative "tina4/container"
 require_relative "tina4/queue"
@@ -52,6 +53,7 @@ require_relative "tina4/response_cache"
 require_relative "tina4/html_element"
 require_relative "tina4/error_overlay"
 require_relative "tina4/test_client"
+require_relative "tina4/docs"
 require_relative "tina4/mcp"
 
 module Tina4
@@ -385,6 +387,16 @@ module Tina4
       Tina4::ServiceRunner.register(name, nil, options, &block)
     end
 
+    # Register a periodic background task.
+    # Mirrors Python's tina4_python.core.server.background(fn, interval) and
+    # PHP's $app->background($callback, $interval).
+    #
+    #   Tina4.background(interval: 5.0) { drain_queue }
+    #   Tina4.background(method(:health_check), interval: 30.0)
+    def background(callback = nil, interval: 1.0, &block)
+      Tina4::Background.register(callback, interval: interval, &block)
+    end
+
     # DI container shortcuts
     def register(name, instance = nil, &block)
       Tina4::Container.register(name, instance, &block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.11.17
+  version: 3.11.19
 platform: ruby
 authors:
 - Tina4 Team
@@ -281,6 +281,7 @@ files:
 - lib/tina4/api.rb
 - lib/tina4/auth.rb
 - lib/tina4/auto_crud.rb
+- lib/tina4/background.rb
 - lib/tina4/cache.rb
 - lib/tina4/cli.rb
 - lib/tina4/constants.rb
@@ -294,6 +295,7 @@ files:
 - lib/tina4/dev.rb
 - lib/tina4/dev_admin.rb
 - lib/tina4/dev_mailbox.rb
+- lib/tina4/docs.rb
 - lib/tina4/drivers/firebird_driver.rb
 - lib/tina4/drivers/mongodb_driver.rb
 - lib/tina4/drivers/mssql_driver.rb