studio-engine 0.82.0 → 0.83.0

data/lib/studio.rb

@@ -13,6 +13,8 @@ require "studio/js_literal"
 require "studio/js_identifier"
 require "studio/partial_block"
 require "studio/sidebar_sections"
+require "studio/site_footer"
+require "studio/booking"
 require "studio/navbar_links"
 require "studio/navbar_identity"
 require "studio/profile_sections"
@@ -516,6 +518,17 @@ module Studio
   # trusted as given.
   mattr_accessor :link_preview_fallback_image, default: "/og.png"
 
+  # The app's CANONICAL base URL for previews, e.g. "https://cyvasse.xyz". When
+  # set, og:url is this base plus the page's path (no query string), and every
+  # relative preview image is made absolute on it — so a share through a
+  # herokuapp.com host or a ?utm_ link does not split one page into many URLs in
+  # an unfurler's share counts. nil (the default) uses the request's base URL,
+  # and og:url is the URL as requested. Set it in production only, or a local
+  # page's card points at production:
+  #
+  #   config.link_preview_base_url = "https://cyvasse.xyz" if Rails.env.production?
+  mattr_accessor :link_preview_base_url, default: nil
+
   # THE SITE IDENTITY'S DRAFTED DEFAULTS — this app's title and description as
   # written in code, under whatever the operator saves at /admin/link_preview.
   # The standing convention is that an agent drafts these when it sets an app up
@@ -547,6 +560,80 @@ module Studio
   #   config.draw_public_user_routes = true
   mattr_accessor :draw_public_user_routes, default: false
 
+  # ---- Site footer and booking (Studio::SiteFooter, Studio::Booking) -------
+  #
+  # The public site's footer: brand and social profiles, link columns, an
+  # optional Location band with a live map, and a legal line. And the booking
+  # primitives: Google Calendar's appointment page inline, in a popup, and on a
+  # page. See docs/SITE_FOOTER.md.
+
+  # The footer's facts: a Hash, or a callable receiving the view. nil (the
+  # default) means this app has no footer, and `studio_site_footer` renders
+  # nothing, so a layout can call it before the app declares one. Every key is
+  # optional; shape and rules: lib/studio/site_footer.rb.
+  #
+  #   config.site_footer = ->(view) {
+  #     { tagline: "Everything, by example",
+  #       address: { street: "123 Example St", city_line: "Washington, DC 20024",
+  #                  lat: 38.8894, lng: -77.0352 },
+  #       columns: [ [ "Company", [ [ "Home", view.root_path ], [ "Career", nil ] ] ] ],
+  #       legal:   [ [ "Privacy Policy", view.privacy_path ] ] }
+  #   }
+  mattr_reader :site_footer, default: nil
+
+  def self.site_footer=(declared)
+    SiteFooter.validate!(declared)
+    @@site_footer = declared
+  end
+
+  # Controllers whose pages keep the footer for a SIGNED-IN viewer, by
+  # controller name ("landing") or path ("admin/reports"). A visitor gets the
+  # footer on every page; a signed-in viewer gets it only here, because every
+  # other signed-in page is a working surface (a board, a queue, an editor) and
+  # stays full height. The engine's own booking page is always included.
+  #
+  #   config.site_footer_controllers = %w[landing packages contact_submissions]
+  mattr_accessor :site_footer_controllers, default: []
+
+  # THE WHOLE RULE for where the footer shows, as one callable receiving the
+  # view. The default is the rule above: every page for a visitor, the listed
+  # controllers for a signed-in viewer. That default shows the footer on ANY page
+  # a signed-out visitor can reach, an app page included, so an app with public
+  # working pages narrows it here. Compose with the default rather than
+  # restating it:
+  #
+  #   config.site_footer_visible = ->(view) {
+  #     Studio::SiteFooter.default_visible?(view) && !view.controller_path.start_with?("games/")
+  #   }
+  mattr_reader :site_footer_visible, default: ->(view) { Studio::SiteFooter.default_visible?(view) }
+
+  def self.site_footer_visible=(rule)
+    SiteFooter.validate_visible!(rule)
+    @@site_footer_visible = rule
+  end
+
+  # The app's Google Calendar appointment schedule: the public link Google gives
+  # you to share, WITHOUT `?gv=true` (the frame and the popup add it). nil (the
+  # default) means no booking: `studio_booking_frame` and `studio_booking_popup`
+  # render nothing and no link opens a popup.
+  #
+  #   config.booking_url = "https://calendar.google.com/calendar/appointments/schedules/EXAMPLE-SCHEDULE-ID"
+  mattr_reader :booking_url, default: nil
+
+  def self.booking_url=(url)
+    Booking.validate!(url)
+    @@booking_url = url.to_s.strip.empty? ? nil : Booking.page_url(url)
+  end
+
+  # Draw the booking page, GET /schedule (Studio::BookingsController, route
+  # helper studio_booking_path). OFF by default, like every route surface a
+  # consumer might already own: mcritchie-studio draws its own /schedule today,
+  # and its adoption turns this on as it deletes that route. With the flag on and
+  # no booking_url the page answers 404.
+  #
+  #   config.draw_booking_routes = true
+  mattr_accessor :draw_booking_routes, default: false
+
   # THE APP'S IDENTITY COPY, resolved: { title:, description:, image_url: }.
   # The operator's saved value (Studio::SiteIdentity, edited at
   # /admin/link_preview) wins, then the drafted Studio.site_title /
@@ -1046,6 +1133,18 @@ module Studio
     SidebarSections.resolve(sidebar_sections, view)
   end
 
+  # The site footer's facts resolved for a view (lib/studio/site_footer.rb), or
+  # nil when the app declared none. The name defaults to the site identity's
+  # title and the logo to the navbar logo, so an app that has set those up says
+  # them once.
+  def self.site_footer_for(view)
+    return nil if site_footer.nil?
+
+    booking_path = draw_booking_routes && view.respond_to?(:studio_booking_path) ? view.studio_booking_path : nil
+    SiteFooter.resolve(site_footer, view,
+                       name: site_identity[:title], logo: logo_for("Footer Logo"), booking_path: booking_path)
+  end
+
   # Navbar links resolved for a view context (lib/studio/navbar_links.rb).
   def self.navbar_links_for(view)
     NavbarLinks.resolve(navbar_links, view)
@@ -1250,6 +1349,12 @@ module Studio
             format: false, constraints: { username: %r{[^/]+} }
       end
 
+      # The booking page (/schedule): Google Calendar's appointment page inline,
+      # with the site footer. OPT-IN — see Studio.draw_booking_routes.
+      if Studio.draw_booking_routes
+        get "schedule", to: "studio/bookings#show", as: :studio_booking
+      end
+
       # The living style guide. Canonical at /admin/style (StyleController#index);
       # /admin/design_system redirects here but KEEPS its admin_design_system_path
       # helper so a shipped host sidebar link on the old helper still resolves.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.82.0
+  version: 0.83.0
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-30 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -309,10 +309,12 @@ files:
 - app/assets/images/state-flags/wy.svg
 - app/assets/javascripts/studio/alpine.js
 - app/assets/javascripts/studio/canvas_confetti.js
+- app/assets/javascripts/studio/leaflet.js
 - app/assets/javascripts/studio/session.js
 - app/assets/javascripts/studio/sortable.js
 - app/assets/javascripts/studio/sticky_table_header.js
 - app/assets/javascripts/studio/studio_confetti.js
+- app/assets/stylesheets/studio/leaflet.css
 - app/assets/stylesheets/studio/sticky_table_header.css
 - app/assets/tailwind/studio_engine/engine-motion.css
 - app/assets/tailwind/studio_engine/engine.css
@@ -334,6 +336,7 @@ files:
 - app/controllers/schema_controller.rb
 - app/controllers/sessions_controller.rb
 - app/controllers/solana_sessions_controller.rb
+- app/controllers/studio/bookings_controller.rb
 - app/controllers/studio/email_images_controller.rb
 - app/controllers/studio/emails_controller.rb
 - app/controllers/studio/geo_settings_controller.rb
@@ -355,6 +358,7 @@ files:
 - app/helpers/studio/geo_helper.rb
 - app/helpers/studio/link_preview_helper.rb
 - app/helpers/studio/public_user_helper.rb
+- app/helpers/studio/site_footer_helper.rb
 - app/helpers/studio_email_delivery_helper.rb
 - app/helpers/studio_navbar_helper.rb
 - app/helpers/studio_sidebar_helper.rb
@@ -445,6 +449,10 @@ files:
 - app/views/studio/board/_board.html.erb
 - app/views/studio/board/_card_shell.html.erb
 - app/views/studio/board/_column.html.erb
+- app/views/studio/booking/_assets.html.erb
+- app/views/studio/booking/_frame.html.erb
+- app/views/studio/booking/_popup.html.erb
+- app/views/studio/bookings/show.html.erb
 - app/views/studio/email_images/index.html.erb
 - app/views/studio/emails/_banner_editor.html.erb
 - app/views/studio/emails/_banner_preview.html.erb
@@ -529,10 +537,16 @@ files:
 - app/views/studio/profiles/show.html.erb
 - app/views/studio/public_users/not_found.html.erb
 - app/views/studio/public_users/show.html.erb
+- app/views/studio/site_footer/_assets.html.erb
+- app/views/studio/site_footer/_footer.html.erb
+- app/views/studio/site_footer/_link.html.erb
+- app/views/studio/site_footer/_map.html.erb
+- app/views/studio/site_footer/_social_icon.html.erb
 - app/views/studio/site_identities/edit.html.erb
 - app/views/style/_host.html.erb
 - app/views/style/_modal_specimen.html.erb
 - app/views/style/_modals.html.erb
+- app/views/style/_site_footer.html.erb
 - app/views/style/_specimen.html.erb
 - app/views/style/_tasks.html.erb
 - app/views/style/_theme.html.erb
@@ -573,6 +587,7 @@ files:
 - lib/generators/studio/site_identity/site_identity_generator.rb
 - lib/studio-engine.rb
 - lib/studio.rb
+- lib/studio/booking.rb
 - lib/studio/cable.rb
 - lib/studio/color_scale.rb
 - lib/studio/email.rb
@@ -605,6 +620,7 @@ files:
 - lib/studio/session_fingerprint.rb
 - lib/studio/session_state.rb
 - lib/studio/sidebar_sections.rb
+- lib/studio/site_footer.rb
 - lib/studio/theme_resolver.rb
 - lib/studio/ui_primitives.rb
 - lib/studio/username_generator.rb