studio-engine 0.4.10 → 0.4.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69ebed5ecf2c4d41815556f20f2c783e71b14c0b381cd07b5f5731fb89d981ba
-  data.tar.gz: 264b1eb9ba0a3bf3bb8abb5fe2ee0d60a2b5abd30c792d307885d7b1dd623475
+  metadata.gz: b843f965201c31cd83f0c1fd3f39830730fbc9e139a31c3a856c3e99853bf053
+  data.tar.gz: c7383f3cf9943f93a2f06150909ee23461d194e93b44c33848bb39106a6f10f9
 SHA512:
-  metadata.gz: ce8cb07a7eeba5953bb5704836721b089ab591bc3d26c2af0ee8c7331f2f0b3734cbea4d506bed5f19b1d187adda3c40a585986413d6617ed80206c9158566cd
-  data.tar.gz: 56fc96ba668bf57fb9cab85cdc7dbc8b02bc9fafb47a6829745b73689dcf5efb3ef0ef9be528ad9764af06f4cf5c7aa1b979c1c3c01776eade15f56a48f2a85a
+  metadata.gz: 2b65ebd2d798a2e06aa2572160d241e2c4557033da6aa3fb2ed4c2bb214e9f2c2119b11cd53e778401f100f318fce49a33531f260e0e8fe05d26449df3281fca
+  data.tar.gz: 8eae952bd9cc78f3705cea486a63fdfb6b667e112c1c207992813b2d3c942bda0fa513f1df4120069b3916703db4bab1d7aabdac3dd6553cacc0a8e239a77353

data/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — `MAJOR.MINOR.PATCH`. Both consumer Rails apps pin to a tag in their `Gemfile`; bumping the tag is a release.
 
+## v0.4.11 (2026-05-24)
+
+Preserves non-dismissible modals (e.g. pending on-chain TX) across bfcache restore and Turbo snapshot caching. Previously, the modal host's cleanup hooks called `closeAll()` on both `pageshow.persisted` and `turbo:before-cache`, which silently dropped any `dismissible: false` modal — including the processing card a still-in-flight JS promise was expecting to resolve against. The promise's `solanaModal.success()` then no-op'd against an empty stack and the user saw nothing despite their TX landing on-chain.
+
+### Added
+- **`Alpine.store('modals').closeAllDismissible()`** — drops every modal in the stack whose `props.dismissible !== false`, leaves locked modals in place.
+
+### Changed
+- **bfcache + Turbo snapshot cleanup** now calls `closeAllDismissible()` instead of `closeAll()`. Celebratory modals still clear on return; pending-TX modals survive.
+
+### Migration
+None required — celebratory modal behavior is unchanged. Consumers relying on `dismissible: false` (turf-monster's `onchain-tx` modal) gain crash-recovery for free.
+
 ## v0.4.10 (2026-05-23)
 
 Lets consumer apps override toast z-indexes without `!important`. Previously, `#toast-container` set `z-index: 60` via an inline `style=` attribute, which forced any consumer override to use `!important`. Same source-order problem for `.toast-page-blur` (z-index in the inline `<style>` block here loaded after the consumer's `application.tailwind.css`). Both now read from CSS custom properties with the previous values as fallback defaults.

data/README.md

@@ -7,13 +7,13 @@ Shared Rails engine for McRitchie apps. Provides authentication, error handling,
 ## Installation
 
 ```ruby
-# Gemfile — pin to a tag (recommended; see Releases section)
-gem "studio-engine", git: "https://github.com/amcritchie/studio-engine.git", tag: "v0.3.0"
+# Gemfile — install from RubyGems (recommended)
+gem "studio-engine", "~> 0.4.0"
 ```
 
-Then `bundle install`. The current release is **v0.3.0**; see [`CHANGELOG.md`](./CHANGELOG.md) for the history.
+Then `bundle install`. The current release is **v0.4.10**; see [`CHANGELOG.md`](./CHANGELOG.md) for the history.
 
-> Pinning to a tag (not `main`) is now the recommended pattern. Consumer apps that track `main` will silently inherit any engine merge — bad when one merge breaks several apps at once.
+> Published to RubyGems as of v0.4.0 (2026-05-17). Earlier consumers used a `git:` ref pinned to a tag; that pattern is preserved here for reference but new installs should use the RubyGems form, which the consumer Rails apps (`mcritchie-studio`, `turf-monster`, `tax-studio`) already use.
 
 ## What It Provides
 

data/app/views/studio/modals/_host.html.erb

@@ -70,6 +70,19 @@
           this.stack = [];
           this._sync();
         },
+        // Drops every modal whose props don't explicitly opt out of dismissal
+        // (i.e. dismissible: false). Used by the bfcache + Turbo snapshot
+        // cleanup below so an in-flight on-chain TX modal — which sets
+        // dismissible: false precisely to forbid losing its UI mid-flight —
+        // survives a back/forward navigation. Celebratory modals (default
+        // dismissible: true) are still cleared so users don't return to a
+        // stale "Success!" card.
+        closeAllDismissible: function() {
+          this.stack = this.stack.filter(function(modal) {
+            return modal.props && modal.props.dismissible === false;
+          });
+          this._sync();
+        },
         isOpen: function(id) {
           for (var i = 0; i < this.stack.length; i++) {
             if (this.stack[i].id === id) return true;
@@ -93,15 +106,23 @@
     //
     // Without this, a user who lands on a celebratory modal and then
     // navigates away (or hits the browser's bfcache on back) sees the
-    // modal again on their next visit. Clear the stack on both signals.
-    function closeAllModals() {
+    // modal again on their next visit. closeAllDismissible() keeps
+    // dismissible: false modals (e.g. pending on-chain TX) so the
+    // user returning via bfcache doesn't silently lose the modal that
+    // a still-in-flight JS promise will resolve against.
+    function clearStaleModals() {
       if (window.Alpine && Alpine.store) {
         var m = Alpine.store('modals');
-        if (m && typeof m.closeAll === 'function') m.closeAll();
+        if (m && typeof m.closeAllDismissible === 'function') {
+          m.closeAllDismissible();
+        } else if (m && typeof m.closeAll === 'function') {
+          // Fallback for older engine versions that registered the store first.
+          m.closeAll();
+        }
       }
     }
-    window.addEventListener('pageshow', function(e) { if (e.persisted) closeAllModals(); });
-    document.addEventListener('turbo:before-cache', closeAllModals);
+    window.addEventListener('pageshow', function(e) { if (e.persisted) clearStaleModals(); });
+    document.addEventListener('turbo:before-cache', clearStaleModals);
   })();
 </script>
 

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.4.10"
+  VERSION = "0.4.11"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.4.10
+  version: 0.4.11
 platform: ruby
 authors:
 - Alex McRitchie