bullet_train 1.0.50 → 1.0.53

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1eb8115bc5740b033b7f934111f0522270c2e83072502f1c4a5acebea63e5ff5
-  data.tar.gz: bd36f0282e6d97331f8eec2def0e941fd6862d6c21549ea0f1b0f289767d576c
+  metadata.gz: 07f9ad294898254375ff48a5348d6eb1cc5e4a67b3916b67c2a9948951510a09
+  data.tar.gz: 7b4b57ad229db84f180acabff26a21320891136bff644dfa38e9c44075da1514
 SHA512:
-  metadata.gz: 9b2c9cc8df78ba5a6e24c574f9564d25876424c25dd95b26f37cf2fa3db59e0a7dc0af6b44b26f69a20cb08855cb3e0d016c2ae7a7289a3157e75d9778ef9c9d
-  data.tar.gz: c886a9a4b1c1df7f4e620af288865ec5942ea6376bdc121516b9b9e580881bab0b2d7fef533551667684fc36ce723b40c62da1ef3af49948bb8e6f800f04ae85
+  metadata.gz: 2fc988b353bfd0b84f18e5506696402628e321f46ce1cfe0e2ab606c29e0c6a6f20e3be9f5f317ffadc82c8af4f0993fd9a2b1f12481b6eb804a161db3facdca
+  data.tar.gz: a9b1fd87a1017b638b6c3a095cb8d3abbef7e86797f6023791e7f8af111b8889b7623df3f6ab8254adedbf42504967ebd9f72f03e4d12a7c7a8ddcf6515c2f85

data/app/views/account/users/_oauth.html.erb

@@ -0,0 +1,2 @@
+<%= render 'account/oauth/stripe_accounts/index', context: @user, stripe_accounts: @user.oauth_stripe_accounts if stripe_enabled? %>
+<% # 🚅 super scaffolding will insert new oauth providers above this line. %>

data/app/views/account/users/edit.html.erb

@@ -23,8 +23,7 @@
       </div>
 
       <div class="xl:col-span-1 space-y-8">
-        <%= render 'account/oauth/stripe_accounts/index', context: @user, stripe_accounts: @user.oauth_stripe_accounts if stripe_enabled? %>
-        <% # 🚅 super scaffolding will insert new oauth providers above this line. %>
+        <%= render 'account/users/oauth' %>
 
         <%= render 'account/shared/box', divider: true do |p| %>
           <% p.content_for :title, t('.password.header') %>

data/app/views/layouts/docs.html.erb

@@ -104,6 +104,12 @@
                     <i class="fal fa-bolt ti ti-bolt"></i>
                   <% end %>
                 <% end %>
+
+                <%= render 'account/shared/menu/item', url: '/docs/javascript', label: 'JavaScript' do |p| %>
+                  <% p.content_for :icon do %>
+                  <i class="fa-brands fa-js ti ti-pulse"></i>
+                  <% end %>
+                <% end %>
               <% end %>
 
               <%= render 'account/shared/menu/section', title: 'Developer Tools' do %>

data/docs/getting-started.md

@@ -51,5 +51,5 @@ If you're using Bullet Train for the first time, begin by learning these five im
     And then paste any input, e.g.:
 
     ```
-    <!-- BEGIN /Users/andrewculver/.rbenv/versions/3.1.1/lib/ruby/gems/3.1.0/gems/bullet_train-themes-light-1.0.10/app/views/themes/light/commentary/_box.html.erb -->
+    <!-- BEGIN /Users/andrewculver/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/bullet_train-themes-light-1.0.10/app/views/themes/light/commentary/_box.html.erb -->
     ```

data/docs/index.md

@@ -12,6 +12,7 @@
  - [Dealing with Indirection](/docs/indirection.md)
  - [Overriding the Framework](/docs/overriding.md)
  - [Setting up a Tunnel](/docs/tunneling.md)
+ - [JavaScript](/docs/javascript.md)
 
 ## Developer Tools
  - [Super Scaffolding](/docs/super-scaffolding.md)

data/docs/indirection.md

@@ -35,7 +35,7 @@ bin/resolve shared/box
 If you're looking at a rendered view in the browser, it can be hard to know which file to open in order to make a change. To help, Bullet Train enables `config.action_view.annotate_rendered_view_with_filenames` by default, so you can right click on any element you see, select "Inspect Element", and you'll see comments in the HTML source telling you which file is powering a particular portion of the view, like this:
 
 ```
-<!-- BEGIN /Users/andrewculver/.rbenv/versions/3.1.1/lib/ruby/gems/3.1.0/gems/bullet_train-themes-light-1.0.10/app/views/themes/light/workflow/_box.html.erb -->
+<!-- BEGIN /Users/andrewculver/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0/gems/bullet_train-themes-light-1.0.10/app/views/themes/light/workflow/_box.html.erb -->
 ```
 
 Note that in the example above, the view in question isn't actually coming from the application repository. Instead, it's being included from the `bullet_train-themes-light` package. For instructions on how to customize it, see [Overriding Framework Defaults](/docs/overriding.md).

data/docs/javascript.md

@@ -0,0 +1,18 @@
+# JavaScript
+Bullet Train leans into the use of [Stimulus](https://stimulus.hotwired.dev) for custom JavaScript. If you haven't read it previously, [the original introductory blog post for Stimulus from 2018](https://medium.com/signal-v-noise/stimulus-1-0-a-modest-javascript-framework-for-the-html-you-already-have-f04307009130) was groundbreaking in its time, and we still consider it required reading for understanding the philosophy of JavaScript in Bullet Train.
+
+## Writing Custom JavaScript
+The happy path for writing new custom JavaScript is to [write it as a Stimulus controller](https://stimulus.hotwired.dev/handbook/building-something-real) in `app/javascript/controllers` and invoke it by augmenting the HTML in your views. If you name the file `*_controller.js`, it will be automatically picked up and compiled as part of your application's JavaScript bundle.
+
+## npm Packages
+npm packages are managed by [Yarn](https://yarnpkg.com) and any required importing can be done in `app/javascript/application.js`.
+
+## Compilation
+Bullet Train uses [esbuild](https://esbuild.github.io) to compile all local JavaScript and npm package dependencies. If you haven't used esbuild before, it's blazing fast compared to older options like Webpack. Honestly, it makes JavaScript development and deployment in complex applications a joy again, in a way it hasn't been for years.
+
+In development, the esbuild process that compiles JavaScript is defined as `yarn build` in `package.json`. This script also has an entry in `Procfile.dev`, so it runs automatically when you start your application with `bin/dev`, and when run in this context, it watches the filesystem and automatically recompiles anytime JavaScript files change on disk.
+
+The resulting JavaScript bundle is output to the `app/assets/builds` directory where it is picked up by the traditional Rails asset pipeline. This directory is listed in `.gitignore`, so the compiled bundles are never committed to the repository.
+
+## React, Vue.js, etc.
+We're not against the use of front-end JavaScript frameworks in the specific contexts where they're the best tool for the job, but we solidly subscribe to the "heavy machinery" philosophy put forward in [that original Stimulus blog post](https://medium.com/signal-v-noise/stimulus-1-0-a-modest-javascript-framework-for-the-html-you-already-have-f04307009130), and have no interest in actually supporting them.

data/docs/permissions.md

@@ -4,7 +4,7 @@
 Bullet Train leans heavily on [CanCanCan](https://github.com/CanCanCommunity/cancancan) for implementing authorization and permissions. (We’re also proud sponsors of its ongoing maintenance.) The original CanCan library by Ryan Bates was, in our opinion, a masterpiece and a software engineering marvel that has stood the test of time. It's truly a diamond among Ruby Gems. If you're not already familiar with CanCanCan, you should [read its documentation](https://github.com/CanCanCommunity/cancancan) to get familiar with its features and DSL.
 
 ## Bullet Train Roles
-Over many years of successfully implementing applications with CanCanCan, it became apparent to us that a supplemental level of abstraction could help streamline and simplify the definition of many common permissions, especially in large applications. We've since extracted this functionality into [a standalone Ruby Gem](https://github.com/bullet-train-co/bullet_train-roles) and moved the documentation that used to be here into [the README for that project](https://github.com/bullet-train-co/bullet_train-roles/blob/main/README.md). Should you encounter situations where this abstraction doesn't meet your specific needs, you can always implement the permissions you need using standard CanCanCan directives in `app/models/ability.rb`.
+Over many years of successfully implementing applications with CanCanCan, it became apparent to us that a supplemental level of abstraction could help streamline and simplify the definition of many common permissions, especially in large applications. We've since extracted this functionality into [a standalone Ruby Gem](https://github.com/bullet-train-co/bullet_train-roles) and moved the documentation that used to be here into [the README for that project](https://github.com/bullet-train-co/bullet_train-roles). Should you encounter situations where this abstraction doesn't meet your specific needs, you can always implement the permissions you need using standard CanCanCan directives in `app/models/ability.rb`.
 
 ## Additional Notes
 

data/lib/bullet_train/version.rb

@@ -1,3 +1,3 @@
 module BulletTrain
-  VERSION = "1.0.50"
+  VERSION = "1.0.53"
 end

data/lib/bullet_train.rb

@@ -97,11 +97,14 @@ def two_factor_authentication_enabled?
   ENV["TWO_FACTOR_ENCRYPTION_KEY"].present?
 end
 
-def any_oauth_enabled?
-  [
-    stripe_enabled?,
-    # 🚅 super scaffolding will insert new oauth provider checks above this line.
-  ].select(&:present?).any?
+# Don't redefine this if an application redefines it locally.
+unless defined?(any_oauth_enabled?)
+  def any_oauth_enabled?
+    [
+      stripe_enabled?,
+      # 🚅 super scaffolding will insert new oauth provider checks above this line.
+    ].select(&:present?).any?
+  end
 end
 
 def invitation_only?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bullet_train
 version: !ruby/object:Gem::Version
-  version: 1.0.50
+  version: 1.0.53
 platform: ruby
 authors:
 - Andrew Culver
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-08 00:00:00.000000000 Z
+date: 2022-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: standard
@@ -490,6 +490,7 @@ files:
 - app/views/account/users/_breadcrumbs.html.erb
 - app/views/account/users/_fields.html.erb
 - app/views/account/users/_form.html.erb
+- app/views/account/users/_oauth.html.erb
 - app/views/account/users/edit.html.erb
 - app/views/account/users/show.html.erb
 - app/views/bullet_train/partial_resolver.html.erb
@@ -575,6 +576,7 @@ files:
 - docs/i18n.md
 - docs/index.md
 - docs/indirection.md
+- docs/javascript.md
 - docs/modeling.md
 - docs/namespacing.md
 - docs/oauth.md