studio-engine 0.57.3 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40225b29271d0e2651ab08ae5047e76ccc4672f4e0a85ac385a0133d013ccaa5
-  data.tar.gz: 35b1f3c01da3a105f80135e94984dd461bdb0f4092e90ec436ec9c9f8300f3aa
+  metadata.gz: 959ea13f16e5896058a274b521d6ebf70ba3b272c5a520f27cae6685c2329cf1
+  data.tar.gz: 90d82b6ea11fc10c66b401b98f62f8675ad1f99037f7f122af97b8e7d86d73e6
 SHA512:
-  metadata.gz: 51eb9be89732de3f038218e3177d279e4f9d5988577fcb6f657e460820ed5da82693604e3c03ee2a305b9a7a75b2ce62f7e0baae2d5614013f980f4dd446b097
-  data.tar.gz: 0aa3fc2ea31cc63129ff6e5592fd303b7826b6aa50a0b2dc100ee0b26cb0e8b34049baeede0440d6e2c301099586d9cef2e4226cdeacb3050a81a1f9a5482983
+  metadata.gz: cb9b85f346c35cfc234751aa79eeec3c22ebac83b0acc40d586b74f28591a063cdefaa05673f4c0844347f7c0e2d11e41606b5058adf15c9c3fa74da9f6b8be8
+  data.tar.gz: 7c974094a1ea66a113f0d93a6a02e7c781bee50d3138026a8431b8127d866090297cd6d526e8957c2a962a637acd39cc9cab27bc14b779ebf05002299e3c0f44

data/CHANGELOG.md

@@ -6,6 +6,20 @@ The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This pro
 
 ### Added
 
+- **A Geo row in the shared admin dropdown, with signage when it is off.** Every
+  app's gear menu now carries **Geo** beside Theme and Error Logs. It links
+  `/admin/geo` when `ENABLE_GEO_BLOCKING` is truthy and the geo routes are drawn;
+  otherwise it renders DISABLED and names the missing prerequisite — "Set
+  ENABLE_GEO_BLOCKING=true" or "Draw the geo routes first".
+
+  Disabled rather than hidden on purpose: an app that has not turned geo on still
+  learns the feature exists and what to set.
+
+  **The variable governs the LINK, never the gate.** An app with it unset still
+  detects, still blocks, still enforces — a default-off variable that switched
+  enforcement would silently stop a live legal blocklist on the next deploy. An
+  app that would rather decide in code sets `config.geo_blocking_enabled`.
+
 - **Geo — validation for every app, locking for the apps that need it.**
   Turf Monster's geo stack, lifted into the engine and generalised from
   US-states-only to country + subdivision. Full guide:

data/app/views/components/_admin_dropdown.html.erb

@@ -13,6 +13,29 @@
   <div x-show="open" x-cloak @click.outside="open = false" x-transition:enter="transition ease-out duration-100" x-transition:enter-start="opacity-0 scale-95" x-transition:enter-end="opacity-100 scale-100" x-transition:leave="transition ease-in duration-75" x-transition:leave-start="opacity-100 scale-100" x-transition:leave-end="opacity-0 scale-95" class="absolute right-0 mt-2 w-44 bg-surface border border-subtle rounded-lg shadow-lg z-50 py-1">
     <a href="/admin/theme" class="block px-4 py-2 text-sm text-body hover:text-heading hover:bg-surface-alt transition">Theme</a>
     <a href="/admin/navbar" class="block px-4 py-2 text-sm text-body hover:text-heading hover:bg-surface-alt transition">Navbar</a>
+    <%# GEO — shown in every app, LIVE only where it can actually be used.
+        A disabled row rather than a hidden one is the whole point: an app that has
+        not turned geo on still learns the feature exists and what to set, instead
+        of it being invisible until someone reads the gem's docs.
+
+        Two prerequisites, and the row says WHICH is missing, because they are
+        fixed in different places — an env var on the dyno, a line in the app's
+        initializer. The route check is not decoration: where draw_geo_routes is
+        false, `admin_geo_path` does not exist and calling it RAISES, so the
+        disabled branch must never reach for the helper. %>
+    <% geo_routes = respond_to?(:admin_geo_path) %>
+    <% if Studio.geo_blocking_enabled? && geo_routes %>
+      <a href="<%= admin_geo_path %>" class="block px-4 py-2 text-sm text-body hover:text-heading hover:bg-surface-alt transition">Geo</a>
+    <% else %>
+      <span class="block px-4 py-2 text-sm text-muted cursor-not-allowed select-none"
+            data-test="admin-dropdown-geo-disabled"
+            title="<%= geo_routes ? "Set ENABLE_GEO_BLOCKING=true to manage geo blocking" : "Set config.draw_geo_routes = true in config/initializers/studio.rb, then ENABLE_GEO_BLOCKING=true" %>">
+        Geo
+        <span class="block text-xs text-muted">
+          <%= geo_routes ? "Set ENABLE_GEO_BLOCKING=true" : "Draw the geo routes first" %>
+        </span>
+      </span>
+    <% end %>
     <a href="/error_logs" class="block px-4 py-2 text-sm text-body hover:text-heading hover:bg-surface-alt transition">Error Logs</a>
   </div>
 </div>

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.57.3"
+  VERSION = "0.58.0"
 end

data/lib/studio.rb

@@ -298,6 +298,29 @@ module Studio
   }
   mattr_accessor :geo_blocked_redirect, default: nil
 
+  # THE OPERATOR-FACING SWITCH for the geo manager's place in the admin chrome:
+  # ENABLE_GEO_BLOCKING, a plain true/false environment variable in the house
+  # ENABLE_* family (ENABLE_COINFLOW, ENABLE_AGE_GATE).
+  #
+  # It governs the LINK AND ITS SIGNAGE, nothing else. An app with it unset still
+  # detects, still blocks, still enforces — this deliberately does NOT gate the
+  # gate. A default-off variable that switched enforcement would silently stop a
+  # live legal blocklist on the next deploy, which is the opposite of what a
+  # signpost is for.
+  #
+  # What it changes: the shared admin dropdown shows Geo as a DISABLED item naming
+  # the variable to set, so an app that has not turned the feature on still learns
+  # it exists and how to reach it — instead of the feature being invisible.
+  mattr_accessor :geo_blocking_enabled, default: nil
+
+  # nil (the default) means "read the environment"; an app that wants to decide in
+  # code sets true/false in its initializer and the variable is ignored.
+  def self.geo_blocking_enabled?
+    return !!geo_blocking_enabled unless geo_blocking_enabled.nil?
+
+    env_truthy?(ENV["ENABLE_GEO_BLOCKING"])
+  end
+
   # Draw /admin/geo + /geo/check from Studio.routes. OFF by default, for the same
   # hard reason as draw_admin_emails_routes: turf-monster already owns
   # admin_geo_path, admin_geo_update_path, admin_geo_toggle_path and

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.57.3
+  version: 0.58.0
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails