brut 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: add23c2780a2ba1fe444b067c50d3451d9b28cd1bacbed9e1ab1693963bcbd03
-  data.tar.gz: 4f44397c6688843f6d4c9f61121879fd711dfcec5b1b024f6a8be038cc84be54
+  metadata.gz: 1b2e311013cbdc55775be537b348e78a8c94d12842bff7fcdc09973f88be7eb9
+  data.tar.gz: 648599f601bbf5fa34ed21f7223b4cf82dcf1f12f58b7b60bdf28d5d56c191b2
 SHA512:
-  metadata.gz: 787f519b6c620c4586af3f53932fdbc6ded220766d36295ae9220d51d795a7c3498438cb6ad89051061731be95ab8c448d4d6c7519d97490e14ff433e954d747
-  data.tar.gz: b76f693147690b5370f8db06747e6d73f3b9cffae625edaabdb0f3469806bbc2b2966d55aacc101c70e3e7c767690c4f1f8052a61677d90a26ec59753392fea8
+  metadata.gz: 913cb4f1328ce98454004702f7e8ded76fcc18d44e090b6b96a50840b54519dcc1cde3f3746d9a772c2e33da8554d8485c28ccc35fd65ca98c154b6693c4ac07
+  data.tar.gz: c4ae0693b14b42f3ba58b10b83f6e98f6e300ddeafd40f89028f42eb1b2c534857d69de5917ff7a4234380fb2123815242ac7a2c805f1939f2f1cee033fa2744

data/.gitignore

@@ -6,11 +6,17 @@
 # should never be checked in
 /dx/credentials
 
+# This is per-developer configuration, generated by dx/build
+/dx/build.args
+
 # Holds metadata during YARD builds. Don't need this checked in
 /.yardoc
 # Location of YARD templates, this is temporary
 /.yard
 
+# This is generated, so no need to check in
+/.rubocop.yml
+
 # This is where generated API docs go
 /brutrb.com/public/api
 /brutrb.com/public/brut-js/api
@@ -42,3 +48,6 @@
 # All I want in life is for every single instance of this file
 # to be placed in hell, and waiting for Alan Dye when he arrives.
 .DS_Store
+
+# Don't want tmp checked in, but want to dump stuff there for sure
+/tmp

data/CHANGELOG.md

@@ -1,8 +1,15 @@
 # Brut CHANGELOG
 
+## v0.9.0 - Aug 7, 2025
+
+* Added `Brut::FrontEnd::CsrfProtector` and the `csrf_protector` configuration option to allow some customization
+  over how CSRF protection works app-wide, namely to allow a POST to a webhook to not have to have an authenticity token.
+  I don't super love this solution, but it's unblocking me for now.
+
 ## v0.8.0 - July 23, 2025
 
 * Moved `mkbrut` into this repo
+* Fixed issue where generated `dx/build` script would mess up `build.args`. See https://github.com/thirdtank/brut/issues/45
 * Unify versioning for Brut, `mkbrut`, BrutJS, and BrutCSS
 * Unify all workspace workflow scripts (see README.md)
 * Minor doc updates to remove references to non-existent `form_tag`

data/Dockerfile.dx

@@ -44,12 +44,19 @@ RUN apt-get install -y vim && \
 ARG user_uid=10001
 # Their group id, which ideally matches their group id on the host
 ARG user_gid=10002
+# The group id that can access /var/run/docker.sock on the host.
+# If this isn't mapped properly, no docker-out-of-docker commands will work
+ARG docker_gid=10003
+# Can be set to ',0' in order to add the user to roo's group
+ARG sadly_user_must_be_added_to_root=
 
 # Create the user's group ID if it does not exist
 RUN getent group ${user_gid} || groupadd --gid ${user_gid} appgroup
+# Create the docker group id if it does not exist
+RUN getent group ${docker_gid} || groupadd --gid ${docker_gid} hostdocker
 # Create the user. Note that we put bash_customizations in both .profile and .bashrc
 # to increase the chances they are used when running bash in various configurations
-RUN useradd --uid ${user_uid} --gid ${user_gid} --create-home --home-dir /home/appuser appuser && \
+RUN useradd --uid ${user_uid} --gid ${user_gid} --groups ${sadly_user_must_be_added_to_root}${docker_gid} --create-home --home-dir /home/appuser appuser && \
     echo ". ~/.bash_customizations" >> /home/appuser/.profile && \
     echo ". ~/.bash_customizations.local" >> /home/appuser/.profile && \
     echo ". ~/.bash_customizations" >> /home/appuser/.bashrc && \

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.8.0)
+    brut (0.9.0)
       concurrent-ruby
       i18n
       irb
@@ -36,6 +36,7 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
+    ast (2.4.3)
     base64 (0.2.0)
     benchmark (0.4.0)
     bigdecimal (3.1.8)
@@ -76,6 +77,9 @@ GEM
       pp (>= 0.6.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
+    json (2.13.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     logger (1.6.1)
     mini_portile2 (2.8.9)
     minitest (5.25.1)
@@ -114,6 +118,10 @@ GEM
     opentelemetry-semantic_conventions (1.10.1)
       opentelemetry-api (~> 1.0)
     ostruct (0.6.1)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
     phlex (2.2.1)
       zeitwerk (~> 2.7)
     pp (0.6.2)
@@ -132,10 +140,12 @@ GEM
       rack (>= 3.0.0)
     rackup (2.2.1)
       rack (>= 3)
+    rainbow (3.1.1)
     rake (13.2.1)
     rdiscount (2.2.7.3)
     rdoc (6.12.0)
       psych (>= 4.0.0)
+    regexp_parser (2.10.0)
     reline (0.6.0)
       io-console (~> 0.5)
     rspec (3.13.0)
@@ -151,6 +161,23 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.1)
+    rubocop (1.74.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.42.0)
+      parser (>= 3.3.7.2)
+    rubocop-disable_syntax (0.2.0)
+      lint_roller
+      rubocop (>= 1.72.0)
+    ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     securerandom (0.3.2)
     semantic_logger (4.16.1)
@@ -169,6 +196,9 @@ GEM
       concurrent-ruby (~> 1.0)
     tzinfo-data (1.2024.2)
       tzinfo (>= 1.0.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
     uri (1.0.2)
     yard (0.9.37)
     zeitwerk (2.7.1)
@@ -192,6 +222,8 @@ DEPENDENCIES
   rdiscount
   rdoc
   rspec (~> 3.0)
+  rubocop
+  rubocop-disable_syntax
   yard
 
 BUNDLED WITH

data/bin/ci

@@ -20,7 +20,15 @@ brutcss_dir = (Pathname(__FILE__).dirname / ".." / "brut-css" ).expand_path.to_s
 mkbrut_dir  = (Pathname(__FILE__).dirname / ".." / "mkbrut" ).expand_path.to_s
 
 log "Running BrutRB tests"
-system!("bin/rspec")
+system!("bin/test")
+
+log "Running mkbrut tests"
+FileUtils.chdir mkbrut_dir do
+  system!("bin/ci")
+end
+
+log "Running Rubcop"
+system!("bin/generate-and-run-rubocop")
 
 log "Running brut-js tests"
 FileUtils.chdir brutjs_dir do
@@ -30,7 +38,3 @@ log "Running brut-css tests"
 FileUtils.chdir brutcss_dir do
   system!("bin/ci")
 end
-log "Running mkbrut tests"
-FileUtils.chdir mkbrut_dir do
-  system!("bin/ci")
-end

data/bin/docs

@@ -37,7 +37,7 @@ log "Hacking CSS"
 
 [
   docs_dir /  "css" / "style.css",
-  docs_dir /  "css" / "full_list.css"
+  docs_dir /  "css" / "full_list.css",
 ].each do |css_file_to_hack|
   lines = File.read(css_file_to_hack).split(/\n/)
   File.open(css_file_to_hack, "w") do |f|

data/bin/generate-and-run-rubocop

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+set -e
+
+SCRIPT_DIR=$( cd -- "$( dirname -- "${0}" )" > /dev/null 2>&1 && pwd )
+ROOT_DIR=$(realpath "$SCRIPT_DIR/..")
+
+usage() {
+  echo "Usage: $0 [-R]"
+  echo
+  echo "    Generates .rubocop.yml and runs rubocop"
+  echo
+  echo "OPTIONS"
+  echo
+  echo "    -R - Do not run rubocop, just generate the configuration"
+  echo
+}
+
+for arg in "$@"; do
+  if [ "${arg}" = "-h" ] || [ "${arg}" = "--help" ] || [ "${arg}" = "help" ]; then
+    usage
+    exit 0
+  fi
+done
+
+RUN_RUBOCOP=true
+while getopts "R" opt "${@}"; do
+  case ${opt} in
+    R )
+      RUN_RUBOCOP=false
+      ;;
+    \? )
+      log "🛑" "Unknown option: ${opt}"
+      usage
+      ;;
+    : )
+      log "🛑" "Invalid option: ${opt} requires an argument"
+      usage
+      ;;
+  esac
+done
+shift $((OPTIND -1))
+
+cd $ROOT_DIR
+echo "[ "$0" ] Generating .rubocop.yml"
+ruby -I "lib" -r brut/rubocop_config -e "Brut::RubocopConfig.new.create_ridiculous_yaml" .rubocop.yml
+if [ "$RUN_RUBOCOP" = true ]; then
+  echo "[ "$0" ] Running rubocop"
+  bin/rubocop
+else
+  echo "[ "$0" ] Not Running rubocop"
+fi

data/bin/rubocop

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/bin/setup

@@ -16,9 +16,15 @@ def setup(update_gems:,setup_credentials:)
     system! "bundle check --no-color || bundle install --no-color --quiet"
   end
 
+  log "Creating Rubocop configuration"
+  system! "bin/generate-and-run-rubocop -R"
+
   log "Installing Ruby LSP"
   system! "gem install ruby-lsp"
 
+  log "Installing rubocop-disable_syntax because I have not set up RubyLSP for bundler yet"
+  system! "gem install rubocop-disable_syntax"
+
   log "Installing JS/TS and CSS LSPs"
   system! "npm install -g typescript typescript-language-server vscode-langservers-extracted"
 
@@ -164,6 +170,46 @@ def setup(update_gems:,setup_credentials:)
       end
     end
 
+    docker_credentials_source = credentials_dir / "dockerhub.credentials"
+    docker_credentials_preamble = [
+      "# Username and PAT for Docker commands",
+      "# The file format is for bin/setup and bin/deploy",
+      "# to coordinate. This file format should be able to be",
+      "# sourced into a bash script via .",
+    ]
+    if !docker_credentials_source.exist?
+      log "#{docker_credentials_source} doesn't exist - creating"
+      File.open(docker_credentials_source,"w") do |file|
+        docker_credentials_preamble.each { |line| file.puts line }
+      end
+    end
+    existing_file = File.read(docker_credentials_source).split(/\n/).reject { 
+      it =~ /^\s*#/
+    }.map { |line|
+      line.split(/=/,2).map(&:strip)
+    }.to_h
+    changed = false
+    if !existing_file.key?("DOCKERHUB_USERNAME")
+      log "What is the username for DockerHub you will use to push mkbrut images?"
+      existing_file["DOCKERHUB_USERNAME"] = gets.chomp
+      changed = true
+    end
+    if !existing_file.key?("DOCKERHUB_PAT")
+      log "What is the Personal Access Token (PAT) for DockerHub you will use to push mkbrut images?"
+      existing_file["DOCKERHUB_PAT"] = gets.chomp
+      changed = true
+    end
+    if changed
+      File.open(docker_credentials_source,"w") do |file|
+        docker_credentials_preamble.each { |line| file.puts line }
+        existing_file.each do |key,value|
+          file.puts "#{key}=#{value}"
+        end
+      end
+    else
+      log "#{docker_credentials_source} exists and looks good"
+    end
+
     log "Setting up BrutJS"
     FileUtils.chdir project_root / "brut-js" do
       system! "bin/setup"

data/bin/test

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require_relative "bin_kit"
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: test [options]\n\n    Runs Brut tests only\n\nOPTIONS\n\n"
+
+  opts.on("-h", "--help", "Display this help message") do
+    puts opts
+    puts
+    exit
+  end
+end.parse!
+
+log "Running BrutRB tests"
+system!("bin/rspec -I specs --require spec_helper -P \"specs/**/*.spec.rb\"")
+

data/brut-css/bin/publish

@@ -18,4 +18,4 @@ for arg in "$@"; do
   fi
 done
 
-npm publish brut-css
+npm publish

data/brut-css/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "brut-css",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "brut-css",
-      "version": "0.8.0",
+      "version": "0.9.0",
       "license": "Hippocratic-2.1",
       "devDependencies": {
         "comment-parser": "^1.4.1",

data/brut-css/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brut-css",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Utility CSS Library for Full Stack Developers",
   "keywords": [
     "css"

data/brut-js/bin/publish

@@ -18,4 +18,4 @@ for arg in "$@"; do
   fi
 done
 
-npm publish brut-js
+npm publish

data/brut-js/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "brut-js",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "brut-js",
-      "version": "0.8.0",
+      "version": "0.9.0",
       "license": "Hippocratic-2.1",
       "devDependencies": {
         "esbuild": "^0.24.0",

data/brut-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brut-js",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "keywords": [ "WebComponents", "Custom Elements" ],
   "bugs": {

data/brut.gemspec

@@ -1,5 +1,7 @@
 lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+if !$LOAD_PATH.include?(lib)
+  $LOAD_PATH.unshift(lib)
+end
 require "brut/version"
 
 Gem::Specification.new do |spec|
@@ -10,7 +12,7 @@ Gem::Specification.new do |spec|
 
   spec.summary       = %q{Web Framework Built around Ruby, Web Standards, Simplicity, and Object-Orientation}
   spec.description   = %q{An opinionated web framework build on web standards}
-  spec.homepage      = "https://naildrivin5.com"
+  spec.homepage      = "https://brutrb.com"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -18,8 +20,10 @@ Gem::Specification.new do |spec|
     spec.metadata["allowed_push_host"] = "https://rubygems.org"
 
     spec.metadata["homepage_uri"] = spec.homepage
-    spec.metadata["source_code_uri"] = "https://naildrivin5.com"
-    spec.metadata["changelog_uri"] = "https://naildrivin5.com"
+    spec.metadata["source_code_uri"] = "https://github.com/thirdtank/brut"
+    spec.metadata["changelog_uri"] = "https://github.com/thirdtank/brut/blob/main/CHANGELOG.md"
+    spec.metadata["documentation_uri"] = "https://brutrb.com/"
+    spec.metadata["rubygems_mfa_required"] = "true"
   else
     raise "RubyGems 2.0 or newer is required to protect against " \
       "public gem pushes."
@@ -34,32 +38,34 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "irb"
-  spec.add_runtime_dependency "ostruct" # squelch some warning - this is not used
-  spec.add_runtime_dependency "concurrent-ruby"
-  spec.add_runtime_dependency "i18n"
-  spec.add_runtime_dependency "nokogiri"
-  spec.add_runtime_dependency "phlex"
-  spec.add_runtime_dependency "prism"
-  spec.add_runtime_dependency "rack-protection"
-  spec.add_runtime_dependency "rackup"
-  spec.add_runtime_dependency "semantic_logger"
-  spec.add_runtime_dependency "sequel"
-  spec.add_runtime_dependency "sinatra"
-  spec.add_runtime_dependency "tzinfo"
-  spec.add_runtime_dependency "tzinfo-data"
-  spec.add_runtime_dependency "zeitwerk"
-  spec.add_runtime_dependency "opentelemetry-sdk"
-  spec.add_runtime_dependency "opentelemetry-exporter-otlp"
+  spec.add_dependency "irb"
+  spec.add_dependency "ostruct" # squelch some warning - this is not used
+  spec.add_dependency "concurrent-ruby"
+  spec.add_dependency "i18n"
+  spec.add_dependency "nokogiri"
+  spec.add_dependency "phlex"
+  spec.add_dependency "prism"
+  spec.add_dependency "rack-protection"
+  spec.add_dependency "rackup"
+  spec.add_dependency "semantic_logger"
+  spec.add_dependency "sequel"
+  spec.add_dependency "sinatra"
+  spec.add_dependency "tzinfo"
+  spec.add_dependency "tzinfo-data"
+  spec.add_dependency "zeitwerk"
+  spec.add_dependency "opentelemetry-sdk"
+  spec.add_dependency "opentelemetry-exporter-otlp"
 
   spec.add_development_dependency "activesupport"
-  spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "yard"
-  spec.add_development_dependency "rdiscount"
-  spec.add_development_dependency "rdoc"
   spec.add_development_dependency "dotenv"
   spec.add_development_dependency "factory_bot"
   spec.add_development_dependency "faker"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rdiscount"
+  spec.add_development_dependency "rdoc"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-disable_syntax"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "yard"
 end

data/brutrb.com/.vitepress/config.mjs

@@ -6,6 +6,9 @@ import jsdocLinker from './plugins/jsdocLinker'
 export default defineConfig({
   title: "Brut RB",
   description: "Documentation for the Brut.RB web framework.",
+  ignoreDeadLinks: [
+    /^https?:\/\/localhost/,
+  ],
   head: [
     ["link", { rel: "icon", href: "/favicon.ico" }],
     [

data/brutrb.com/database-schema.md

@@ -142,7 +142,7 @@ unique keys is trivial, so Brut provides a way to do that.
 > A **key** simply uniquely identifies a row or is a unique constraint on a table.
 > Tables have only one primary key, but potentially many keys. Brut uses
 > *synthetic* (sometimes called *surrogate*) keys as primary keys.  This means
-> they have no business meaning and can be safely used for foreighn keys
+> they have no business meaning and can be safely used for foreign keys
 > and other cases without conflating them with domain concepts.
 
 

data/brutrb.com/recipes/migrations.md

@@ -66,7 +66,7 @@ bin/db migrate
 > [!IMPORTANT]
 > This only applied migrations to the dev database.  `bin/ci` and `bin/test e2e`
 > will apply them to the test database, but you may need to do it yourself via
-> `bin/db migration -e test`
+> `bin/db migrate -e test`
 
 > [!NOTE]
 > There is no down migration. If you need to change and re-apply this before

data/docker-compose.dx.yml

@@ -12,6 +12,9 @@ services:
       - type: bind
         source: ${GIT_CONFIG}
         target: "/home/appuser/.gitconfig"
+      - type: bind
+        source: "/var/run/docker.sock"
+        target: "/var/run/docker.sock"
     command: /home/appuser/show-help-in-app-container-then-wait.sh
     working_dir: ${PWD}
     environment:

data/docs/404.html

@@ -9,7 +9,7 @@
     <link rel="preload stylesheet" href="/assets/style.B1z60PPQ.css" as="style">
     <link rel="preload stylesheet" href="/vp-icons.css" as="style">
     
-    <script type="module" src="/assets/app.DyQLb4Ot.js"></script>
+    <script type="module" src="/assets/app.CmkhEsw7.js"></script>
     <link rel="icon" href="/favicon.ico">
     <meta property="og:title" content="BrutRB Documentation">
     <meta property="og:type" content="website">
@@ -20,7 +20,7 @@
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"BxjHi9-8\",\"ai.md\":\"Cy9GWnER\",\"assets.md\":\"7C3HWkga\",\"brut-js.md\":\"B4GYxQVw\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"CjsktgFz\",\"components.md\":\"DHh-NwKs\",\"configuration.md\":\"D8Wz3oJU\",\"css.md\":\"CltvJqAa\",\"custom-element-tests.md\":\"B_rbta32\",\"database-access.md\":\"gnluu54N\",\"database-schema.md\":\"C5gXexJi\",\"deployment.md\":\"BLseERGV\",\"dev-environment.md\":\"DRH2D2-O\",\"dir-structure.md\":\"CWir1pic\",\"doc-conventions.md\":\"DOkAuXlt\",\"end-to-end-tests.md\":\"DzqRpZ43\",\"features.md\":\"DPFXsy0z\",\"flash-and-session.md\":\"nPvUpnUx\",\"form-constraints.md\":\"DK5adCgM\",\"forms.md\":\"BRE85eju\",\"getting-started.md\":\"2ioiTe-B\",\"handlers.md\":\"h84MMB1R\",\"hooks.md\":\"Jmb5VOLA\",\"i18n.md\":\"BAm9t9JJ\",\"index.md\":\"Bn9e0sRJ\",\"instrumentation.md\":\"BgcaGVYH\",\"javascript.md\":\"DzrMxUmI\",\"jobs.md\":\"S-2amAYp\",\"keyword-injection.md\":\"95Zgh2eN\",\"layouts.md\":\"CVGl9xIO\",\"lsp.md\":\"Dn1rIiW0\",\"markdown-examples.md\":\"CCFEQO44\",\"middleware.md\":\"Czz_UlJN\",\"overview.md\":\"DlKiRRG_\",\"pages.md\":\"B7Hc-i6H\",\"recipes_alternate-layouts.md\":\"BwEytl59\",\"recipes_authentication.md\":\"Dzvi_g69\",\"recipes_blank-layouts.md\":\"fyAUJyJR\",\"recipes_custom-flash.md\":\"CrQbI5eH\",\"recipes_indexed-forms.md\":\"CstYyOSo\",\"recipes_migrations.md\":\"DPN3gQE3\",\"recipes_text-field-component.md\":\"H4wLAK0Z\",\"roadmap.md\":\"C6PRi0DX\",\"routes.md\":\"BD6y2i-f\",\"security.md\":\"C0G_AZR-\",\"seed-data.md\":\"BvFZlqIk\",\"space-time-continuum.md\":\"xl44xDos\",\"tutorial.md\":\"BIb7XT6j\",\"unit-tests.md\":\"DUGrnLj5\",\"why.md\":\"C-hk5xgJ\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Blank Layouts\",\"link\":\"/recipes/blank-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"BxjHi9-8\",\"ai.md\":\"Cy9GWnER\",\"assets.md\":\"7C3HWkga\",\"brut-js.md\":\"B4GYxQVw\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"CjsktgFz\",\"components.md\":\"-22ecBxM\",\"configuration.md\":\"CLKL1lFf\",\"css.md\":\"CltvJqAa\",\"custom-element-tests.md\":\"B_rbta32\",\"database-access.md\":\"gnluu54N\",\"database-schema.md\":\"LpmBPVEU\",\"deployment.md\":\"BLseERGV\",\"dev-environment.md\":\"DRH2D2-O\",\"dir-structure.md\":\"CWir1pic\",\"doc-conventions.md\":\"DOkAuXlt\",\"end-to-end-tests.md\":\"DzqRpZ43\",\"features.md\":\"DPFXsy0z\",\"flash-and-session.md\":\"nPvUpnUx\",\"form-constraints.md\":\"DK5adCgM\",\"forms.md\":\"CBI5--o2\",\"getting-started.md\":\"D5nzBZ4J\",\"handlers.md\":\"h84MMB1R\",\"hooks.md\":\"Jmb5VOLA\",\"i18n.md\":\"BAm9t9JJ\",\"index.md\":\"Bn9e0sRJ\",\"instrumentation.md\":\"BgcaGVYH\",\"javascript.md\":\"DzrMxUmI\",\"jobs.md\":\"S-2amAYp\",\"keyword-injection.md\":\"95Zgh2eN\",\"layouts.md\":\"CVGl9xIO\",\"lsp.md\":\"Dn1rIiW0\",\"markdown-examples.md\":\"CCFEQO44\",\"middleware.md\":\"Czz_UlJN\",\"overview.md\":\"DlKiRRG_\",\"pages.md\":\"B7Hc-i6H\",\"recipes_alternate-layouts.md\":\"BwEytl59\",\"recipes_authentication.md\":\"Dzvi_g69\",\"recipes_blank-layouts.md\":\"fyAUJyJR\",\"recipes_custom-flash.md\":\"CrQbI5eH\",\"recipes_indexed-forms.md\":\"CstYyOSo\",\"recipes_migrations.md\":\"CTcnWDJF\",\"recipes_text-field-component.md\":\"H4wLAK0Z\",\"roadmap.md\":\"C6PRi0DX\",\"routes.md\":\"BD6y2i-f\",\"security.md\":\"C0G_AZR-\",\"seed-data.md\":\"BvFZlqIk\",\"space-time-continuum.md\":\"xl44xDos\",\"tutorial.md\":\"BIb7XT6j\",\"unit-tests.md\":\"DUGrnLj5\",\"why.md\":\"C-hk5xgJ\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Blank Layouts\",\"link\":\"/recipes/blank-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
     
   </body>
 </html>