studio-engine 0.60.0 → 0.60.2

data/app/views/style/modals/_wallet_setup.html.erb

@@ -0,0 +1,112 @@
+<%#
+  Living style guide specimen — the onboarding chain's LAST step, "Set up your
+  wallet" (chain step 3 of 3).
+
+  This documents an APP-SPECIFIC flow. The engine deliberately does NOT own it:
+  turf-monster's app/views/modals/_wallet_setup.html.erb is ~576 lines of
+  extension-presence polling, a hosted 90-second walkthrough video, a Detailed
+  Guide route that resolves at render time, and a managed-wallet fallback for
+  grandfathered web2 accounts. None of that is shareable — it is one app's
+  answer to "how do we get this person a wallet".
+
+  What IS shared, and all this specimen composes, is the CHROME:
+    studio/modals/blocks/shell               — title row + close
+    studio/modals/blocks/progress_pill       — the 3-of-3 chain position
+    studio/modals/blocks/wallet_brand_sprite — inline brand marks, no per-app PNG
+  plus the house wallet-row idiom (brand tile, the wallet's own name, status on
+  the right, chevron) and pulse-cta, so a wallet reads identically here, in the
+  connect picker, and on the web3 step-up card.
+
+  ONE card, ONE id, a `detected` TOGGLE for the two ends of the real progression
+  (install -> waiting -> Installed -> connect). Deliberately not two specimens
+  sharing a modal id: that shape is what left the two web3-step-up cards unable
+  to tell each other apart in the glow, fixed in the same pass that added this.
+
+  WHO SEES IT — the half worth remembering. This card and the web3 step-up card
+  are OPPOSITE populations and no user can ever meet both. WalletSetupPolicy
+  exits at its own step 1 for an account that already holds a wallet; the step-up
+  card is only ever shown to accounts that DO hold one. "Get a wallet" vs "prove
+  the wallet you have".
+
+  Self-contained: no install detection, no video embed, no real routes. The
+  walkthrough is represented as a still placeholder rather than an <iframe>,
+  because the video is the app's asset and an embed here would reach off-host.
+
+  Single root: the outer <div> is the host's required root.
+%>
+<div x-data="{
+       get props() { var c = Alpine.store('dsModals').current(); return (c && c.props) || {}; },
+       get detected() { return !!this.props.detected; }
+     }"
+     class="relative">
+  <%= render "studio/modals/blocks/wallet_brand_sprite" %>
+
+  <%= render layout: "studio/modals/blocks/shell",
+        locals: { title: "Set up your wallet", modal_store: "dsModals" } do %>
+
+    <%# Chain position — the HOST's, not this page's. It is the only one of the
+        three onboarding steps that fills the pill, which is why the pill is here
+        even though the card sits in the Web3 section beside the wallet cards. %>
+    <div class="mb-3">
+      <%= render "studio/modals/blocks/progress_pill", current: 3, total: 3 %>
+    </div>
+
+    <p class="text-sm text-body text-center mb-4">
+      This app runs on the Solana public blockchain; you will need a wallet to
+      enter contests and collect winnings.
+    </p>
+
+    <%# THE wallet row — the house idiom, glowing because it is the one thing to
+        press. Same shape the connect picker and the step-up card use. The right
+        side is the only part that moves: INSTALL before the extension exists,
+        an Installed badge once it answers. %>
+    <button type="button" @click="$store.dsModals.close()"
+            style="--pulse-cta-color: var(--color-primary); --pulse-cta-strength: 0.4; --pulse-cta-scale: 1.02"
+            class="pulse-cta w-full flex items-center gap-3 p-3 rounded-xl bg-surface-alt border border-strong hover:bg-surface transition text-left">
+      <span class="w-9 h-9 rounded-lg overflow-hidden flex items-center justify-center shrink-0">
+        <svg class="w-9 h-9" aria-hidden="true"><use href="#se-wallet-phantom"></use></svg>
+      </span>
+      <span class="font-semibold text-heading">Phantom</span>
+      <span class="ml-auto flex items-center gap-2">
+        <span x-show="!detected" class="text-xs text-muted uppercase tracking-wide">Install</span>
+        <span x-show="detected" class="badge border-primary text-primary">Installed</span>
+        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" class="w-4 h-4 text-muted">
+          <path stroke-linecap="round" stroke-linejoin="round" d="m8.25 4.5 7.5 7.5-7.5 7.5" />
+        </svg>
+      </span>
+    </button>
+
+    <%# The teaching half. A brand-new player does not know what a wallet IS, so
+        the card carries its own explainer rather than sending them away to find
+        one. Represented, not embedded — see the header. %>
+    <div class="mt-4 pt-4 border-t border-strong">
+      <h4 class="text-heading font-bold text-sm mb-1">New to Solana &#129300;</h4>
+      <p class="text-sm text-body mb-3">Set up your wallet in <strong>90 seconds</strong>.</p>
+
+      <div class="rounded-lg border border-subtle bg-inset aspect-video flex flex-col items-center justify-center gap-1">
+        <span class="text-2xl leading-none" aria-hidden="true">&#9654;&#65039;</span>
+        <span class="text-2xs text-muted">walkthrough &mdash; the app supplies the video</span>
+      </div>
+
+      <button type="button" @click="$store.dsModals.close()"
+              class="btn btn-primary btn-lg w-full mt-3 flex items-center justify-center gap-2">
+        Detailed Guide
+        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" class="w-4 h-4">
+          <path stroke-linecap="round" stroke-linejoin="round" d="m8.25 4.5 7.5 7.5-7.5 7.5" />
+        </svg>
+      </button>
+    </div>
+
+    <%# Dismissible by design, and the fine print says what dismissing costs. The
+        chain is skippable; the entry gate is not, and the card is honest that
+        the two are different things. %>
+    <button type="button" @click="$store.dsModals.close()"
+            class="block mx-auto mt-4 text-sm text-secondary hover:text-heading transition">
+      Maybe later
+    </button>
+    <p class="mt-2 text-center text-2xs text-muted">
+      Rather pay by card? Link a wallet first &mdash; an entry token needs
+      somewhere to land.
+    </p>
+  <% end %>
+</div>

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.60.0"
+  VERSION = "0.60.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.60.0
+  version: 0.60.2
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-22 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -401,8 +401,8 @@ files:
 - app/views/schema/index.html.erb
 - app/views/sessions/_sso_continue.html.erb
 - app/views/sessions/new.html.erb
-- app/views/studio/_age_verify_assets.html.erb
 - app/views/studio/_at_time_script.html.erb
+- app/views/studio/_birthday_assets.html.erb
 - app/views/studio/_board_assets.html.erb
 - app/views/studio/_confirm_interstitial.html.erb
 - app/views/studio/_cropper_assets.html.erb
@@ -446,7 +446,8 @@ files:
 - app/views/studio/modals/_scoped_host.html.erb
 - app/views/studio/modals/_web3_step_up.html.erb
 - app/views/studio/modals/auth/_resend_footer.html.erb
-- app/views/studio/modals/blocks/_age_verify.html.erb
+- app/views/studio/modals/blocks/_age_gate.html.erb
+- app/views/studio/modals/blocks/_birthday.html.erb
 - app/views/studio/modals/blocks/_card_header.html.erb
 - app/views/studio/modals/blocks/_change_username.html.erb
 - app/views/studio/modals/blocks/_cta_redirect.html.erb
@@ -502,12 +503,24 @@ files:
 - app/views/style/_tricks.html.erb
 - app/views/style/board/_demo_card.html.erb
 - app/views/style/index.html.erb
-- app/views/style/modals/_age_verify.html.erb
+- app/views/style/modals/_age_gate.html.erb
 - app/views/style/modals/_auth.html.erb
+- app/views/style/modals/_birthday.html.erb
+- app/views/style/modals/_cosign_rejected.html.erb
+- app/views/style/modals/_email_change_pending.html.erb
 - app/views/style/modals/_entry_tokens.html.erb
+- app/views/style/modals/_it_begins.html.erb
+- app/views/style/modals/_network_guard.html.erb
+- app/views/style/modals/_newsletter_email.html.erb
 - app/views/style/modals/_onchain_tx.html.erb
+- app/views/style/modals/_quest_success.html.erb
+- app/views/style/modals/_rate_limit_general.html.erb
+- app/views/style/modals/_unsubscribe_confirm.html.erb
+- app/views/style/modals/_unsubscribe_goodbye.html.erb
+- app/views/style/modals/_wallet_changed.html.erb
 - app/views/style/modals/_wallet_connect.html.erb
 - app/views/style/modals/_wallet_deposit.html.erb
+- app/views/style/modals/_wallet_setup.html.erb
 - app/views/theme_settings/edit.html.erb
 - app/views/user_mailer/magic_link.html.erb
 - app/views/user_mailer/magic_link.text.erb

data/app/views/studio/modals/blocks/_age_verify.html.erb

@@ -1,82 +0,0 @@
-<%#
-  Age-gate DOB modal — engine primitive. Collects a real date of birth
-  (Month / Day / Year), shows a live "too young" hint, and submits. Homed in the
-  engine as the heavier sibling of studio/modals/shared/_age_attestation (the
-  lighter one-checkbox legal attestation). RUN ONE OR THE OTHER, not both: the
-  attestation is a signup-time "I confirm I'm of legal age" checkbox; this is an
-  entry-time DOB gate that a server can recompute and stamp.
-
-  CRITICAL — the engine hardcodes NO legal policy. It renders the modal UI, the
-  DOB fields, and the submit; everything legal is app-supplied:
-
-    min_age     (Integer, REQUIRED) — the app's minimum age. There is NO engine
-                default (18 is itself a policy value); the app resolves it from
-                its own policy against its own server-detected jurisdiction.
-    submit_url  (String, REQUIRED)  — the app endpoint the DOB POSTs to. The
-                app owns the authoritative recompute + DOB persistence; the modal
-                only shows the response.
-    state       (String, optional)  — a PASSIVE jurisdiction label for the copy
-                (e.g. "CA"). Server-detected upstream; the modal never detects
-                geography and never offers an editable state field (a spoofable
-                client state must not be able to lower the bar). Blank => the
-                jurisdiction clause is dropped.
-    title       (String, optional)  — modal title. Default "Verify your age".
-    intro       (String, optional)  — the lead sentence after the age line.
-    fine_print  (String, optional)  — the app's legal / jurisdiction copy (e.g.
-                its per-state age table). The engine ships only a neutral,
-                policy-free default; the app passes its real copy here.
-    modal_store (String, optional)  — Alpine store backing close(). Default "modals".
-    demo        (Boolean, optional) — style-guide preview: resolve locally, no POST.
-
-  Requires window.ageVerifyModal — render studio/_age_verify_assets once at
-  layout level (the factory can't ship inside this template; a cloned script
-  never runs). Single root element (modal-host template mount rule).
-%>
-<%
-  min_age     = local_assigns.fetch(:min_age)
-  submit_url  = local_assigns.fetch(:submit_url)
-  state       = local_assigns[:state].to_s.strip
-  title       = local_assigns.fetch(:title, "Verify your age")
-  intro       = local_assigns.fetch(:intro, "Enter your date of birth to confirm you're eligible — we only ask once.")
-  fine_print  = local_assigns.fetch(:fine_print, "We use your date of birth only to confirm eligibility.")
-  modal_store = local_assigns.fetch(:modal_store, "modals")
-  demo        = local_assigns.fetch(:demo, false)
-%>
-<div x-data="ageVerifyModal({ minAge: <%= min_age.to_i %>, state: '<%= j state %>', url: '<%= j submit_url %>', store: '<%= j modal_store %>', demo: <%= demo ? 'true' : 'false' %> })">
-  <%= render layout: "studio/modals/blocks/shell", locals: { title: title, modal_store: modal_store } do %>
-    <p class="text-sm text-muted mb-4">
-      You must be <span class="text-heading font-semibold"><%= min_age %>+</span><%= state.present? ? " in #{state}" : "" %>.
-      <%= intro %>
-    </p>
-
-    <%# Month / Day / Year — the engine's one DOB field, shared with the profile
-        page's birthday row. It lived here first and turf-monster forked a second
-        copy; extracting it is what stops the two drifting. %>
-    <div class="mb-4">
-      <%= render "studio/fields/date_of_birth" %>
-    </div>
-
-    <%# Live too-young hint — shown once a full date is picked and it fails the
-        app-supplied bar, so the user sees the problem before submitting. %>
-    <template x-if="complete && computedAge !== null && minAge && computedAge < minAge">
-      <p class="text-red-400 text-sm mb-3" x-text="'You must be ' + minAge + '+' + (stateCode ? ' in ' + stateCode : '') + '.'"></p>
-    </template>
-
-    <%# Server error (invalid date, or the authoritative too-young check). %>
-    <template x-if="error">
-      <p class="text-red-400 text-sm mb-3" x-text="error"></p>
-    </template>
-
-    <button type="button" @click="submit()"
-            class="btn btn-primary btn-lg w-full"
-            :disabled="!complete || submitting || (computedAge !== null && minAge && computedAge < minAge)">
-      <span x-show="!submitting">Confirm &amp; Continue</span>
-      <span x-show="submitting" class="inline-flex items-center justify-center gap-2" style="display: none;">
-        <span class="cta-spinner" aria-hidden="true"></span>
-        Verifying…
-      </span>
-    </button>
-
-    <p class="text-[11px] text-muted text-center mt-3 leading-snug"><%= fine_print %></p>
-  <% end %>
-</div>

data/app/views/style/modals/_age_verify.html.erb

@@ -1,17 +0,0 @@
-<%#
-  Living style guide specimen for the engine age-gate DOB modal
-  (studio/modals/blocks/_age_verify). Opened on the page-scoped dsModals host.
-
-  The whole point of this specimen is the SEAM: every legal value here is a DEMO
-  the app feeds — the engine primitive hardcodes none of it. So we pass an
-  illustrative policy (21+ in CA) and a demo fine_print that SAYS so, and run in
-  demo mode (no backend — submit resolves locally). A real app swaps these for
-  its own min_age / state / submit_url / legal copy resolved server-side.
-%>
-<%= render "studio/modals/blocks/age_verify",
-      min_age:     21,
-      state:       "CA",
-      submit_url:  "#demo-age-verify",
-      modal_store: "dsModals",
-      demo:        true,
-      fine_print:  "Demo policy the app supplies: 21+ in CA. The engine hardcodes no age and no state table — your app passes min_age, the jurisdiction label, this copy, and the endpoint that recomputes it server-side." %>