brut 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a56f9e1afcd603bfe486a0698fb8072544704e86ac9c2389c7729212153b0848
-  data.tar.gz: 0d1355defb5b29e4bc16e458d4434ed96e9c6bd87f511639b8794626ad1c2c48
+  metadata.gz: 6715d0f8a6d8d1471cd31f4ab2ebe27ecec83d1e758545f477c8c1438d266219
+  data.tar.gz: 7aa0e9b6d0b1c18be69fe89c96ba4faed49b0169dd65ce310a9aeac55896fad3
 SHA512:
-  metadata.gz: 1ddf86edb8b5a3faed88bf49d64c9c31fe56adae7ae7b8bc882be328f1c2c7aca8849088e631d999e486bd8d5f9ae757b4facd785a03d5f00be8ddfb34582068
-  data.tar.gz: 004bd287e73955fdaf7a61bce74c542663c460edc3703eec4be7a8e42fd92b956c93f60e6f9cdd8592def55bb2a01e0f462f0d8f0aa1f14cd4e2c54805d6402d
+  metadata.gz: e6889484ea8547d47751b7fff9a680d82508831a692081dfb441fb8a58faade8486c5201f9161bc478572d8915e0aa1657161f156d5adf912d94d4a199f763b2
+  data.tar.gz: b882301738459b9df68b093d03fcd69c7f62d800169bc6044615577e7e3337b79637b126aa10827e58fbbf16b49c58d680f777900c11d60f11410492e9993fa3

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Brut CHANGELOG
 
+## v0.4.0 - July 12, 2025
+
+* **Breaking Change** - changed `cv.fe` and `cv.be` I18n keys to `cv.cs` and `cv.ss`
+  - This is to be consistent with Brut terminology
+  - To address this change:
+    1. Update brut-js to 0.0.22
+    2. Modify your `app/config/*/*.rb` i18n files to change `cv:` to `cs:` and `be:`
+       to `ss:`
+    3. Change `app/src/front_end/layouts/default_layout.rb`:
+
+       ```diff
+       -        I18nTranslations("cv.fe")
+       +        I18nTranslations("cv.cs")
+       ```
+    4. Change anywhere in your code or tests that you refer to those keys
+* Added `#valid?` to `Brut::FrontEnd::Form` to make it easier to check a lack
+  of constraint violations
+
+## v0.3.1 - July 12, 2025
+
+* **`bin/db new_migration` includes link to the migrations recipe**
+
 ## v0.3.0 - July 11, 2025
 
 * **`bin/scaffold form` generates correct handler code**

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.3.0)
+    brut (0.4.0)
       concurrent-ruby
       i18n
       irb

data/brut-js/CHANGELOG.md

@@ -0,0 +1,5 @@
+# BrutJS CHANGELOG
+
+## v0.0.22
+
+* Changed i18n key from cv.fe to cv.cs ("front-end" to "client-side") to be more consistent with Brut terminology

data/brut-js/package-lock.json

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

data/brut-js/package.json

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

data/brut-js/specs/ConstraintViolationMessage.spec.js

@@ -23,7 +23,7 @@ describe("<brut-cv>", () => {
   withHTML(`
     <brut-i18n-translation key="problem"                     value="%{field} has a problem"></brut-i18n-translation>
     <brut-i18n-translation key="cv.this_field"               value="THAT FIELD"></brut-i18n-translation>
-    <brut-i18n-translation key="cv.fe.fieldNames.some-field" value="Some Field"></brut-i18n-translation>
+    <brut-i18n-translation key="cv.cs.fieldNames.some-field" value="Some Field"></brut-i18n-translation>
 
     <brut-cv input-name="some-field" key="problem"></brut-cv>
   `).test("Inserts using the this_field key as the placeholder", ({document,assert}) => {

data/brut-js/specs/ConstraintViolationMessages.spec.js

@@ -2,8 +2,8 @@ import { withHTML } from "./SpecHelper.js"
 
 describe("<brut-cv-messages>", () => {
   withHTML(`
-    <brut-i18n-translation key="cv.fe.patternMismatch" value="%{field} does not match the pattern"></brut-i18n-translation>
-    <brut-i18n-translation key="cv.fe.rangeOverflow" value="%{field} is above the range"></brut-i18n-translation>
+    <brut-i18n-translation key="cv.cs.patternMismatch" value="%{field} does not match the pattern"></brut-i18n-translation>
+    <brut-i18n-translation key="cv.cs.rangeOverflow" value="%{field} is above the range"></brut-i18n-translation>
 
     <brut-cv-messages input-name="some-field"></brut-cv-messages>
   `).test("Inserts constraint violation messages based on validity state", ({document,assert}) => {

data/brut-js/specs/Form.spec.js

@@ -51,9 +51,9 @@ describe("<brut-form>", () => {
     assert(gotInvalid)
     assert.equal(brutForm.getAttribute("submitted-invalid"),"")
 
-    let error = textFieldLabel.querySelector("brut-cv[key='cv.fe.valueMissing']")
+    let error = textFieldLabel.querySelector("brut-cv[key='cv.cs.valueMissing']")
     assert(error)
-    error = numberFieldLabel.querySelector("brut-cv[key='cv.fe.valueMissing']")
+    error = numberFieldLabel.querySelector("brut-cv[key='cv.cs.valueMissing']")
     assert(error)
 
     const textField = textFieldLabel.querySelector("input")
@@ -71,9 +71,9 @@ describe("<brut-form>", () => {
     assert(gotInvalid)
     assert.equal(brutForm.getAttribute("submitted-invalid"),"")
 
-    error = textFieldLabel.querySelector("brut-cv[key='cv.fe.valueMissing']")
+    error = textFieldLabel.querySelector("brut-cv[key='cv.cs.valueMissing']")
     assert(!error)
-    error = numberFieldLabel.querySelector("brut-cv[key='cv.fe.valueMissing']")
+    error = numberFieldLabel.querySelector("brut-cv[key='cv.cs.valueMissing']")
     assert(error)
 
     const numberField = numberFieldLabel.querySelector("input")
@@ -174,7 +174,7 @@ describe("<brut-form>", () => {
     assert(gotInvalid)
     assert.equal(brutForm.getAttribute("submitted-invalid"),"")
 
-    let error = brutForm.querySelector("brut-cv[input-name='text'][key='cv.fe.valueMissing']")
+    let error = brutForm.querySelector("brut-cv[input-name='text'][key='cv.cs.valueMissing']")
     assert(error)
 
   })

data/brut-js/src/ConstraintViolationMessage.js

@@ -7,7 +7,7 @@ import I18nTranslation from "./I18nTranslation"
  *
  * Here is how the field's name is determined:
  *
- * 1. It will look for a `<brut-i18n-translation>` element with the `key` `cv.fe.fieldNames.«input-name»`.
+ * 1. It will look for a `<brut-i18n-translation>` element with the `key` `cv.cs.fieldNames.«input-name»`.
  * 2. If that's not found, it will attempt to use "this field" by locating a `<brut-i18n-translation>` element with the `key`
  *    `cv.this_field` (the underscore being what is used on Brut's server side).
  * 3. If that is not found, it will use the literaly string "this field" and emit a console warning.
@@ -37,7 +37,7 @@ class ConstraintViolationMessage extends BaseCustomElement {
 
   static createElement(document,attributes) {
     const element = document.createElement(ConstraintViolationMessage.tagName)
-    element.setAttribute("key",this.i18nKey("fe", attributes.key))
+    element.setAttribute("key",this.i18nKey("cs", attributes.key))
     element.setAttribute("input-name",attributes["input-name"])
     if (Object.hasOwn(attributes,"show-warnings")) {
       element.setAttribute("show-warnings",attributes["show-warnings"])
@@ -79,7 +79,7 @@ class ConstraintViolationMessage extends BaseCustomElement {
   }
 
   inputNameChangedCallback({newValue}) {
-    this.#inputNameKey = this.#i18nKey("fe", "fieldNames", newValue)
+    this.#inputNameKey = this.#i18nKey("cs", "fieldNames", newValue)
   }
 
   serverSideChangedCallback({newValueAsBoolean}) {

data/brut-js/src/ConstraintViolationMessages.js

@@ -38,9 +38,9 @@ class ConstraintViolationMessages extends BaseCustomElement {
    * This should be called as part of a Form validation event to provide a customized UX for
    * the error messages, beyond what the browser would do by default.  The keys used are the same
    * as the attributes of a `ValidityState`, so for example, a range underflow would mean that `validity.rangeUnderflow` would return
-   * true.  Thus, a `<brut-cv>` would be created with `key="cv.fe.rangeUnderflow"`.
+   * true.  Thus, a `<brut-cv>` would be created with `key="cv.cs.rangeUnderflow"`.
    *
-   * The `cv.fe` is hard-coded to be consistent with Brut's server-side translation management.
+   * The `cv.cs` is hard-coded to be consistent with Brut's server-side translation management.
    *
    * @param {ValidityState} validityState - the return from an element's `validity` when it's found to have constraint violations.
    * @param {String} inputName - the element's `name`.

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

@@ -126,6 +126,7 @@ export default defineConfig({
         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" },

data/brutrb.com/database-schema.md

@@ -19,8 +19,7 @@ Brut's provides this via Sequel. See [both](https://sequel.jeremyevans.net/rdoc/
 
 ### Creating Migrations
 
-To create a migration, use `bin/db new-migration`. It accepts any  number of arguments that will be joined
-together to form the filename:
+To create a migration, use `bin/db new-migration`. It accepts any  number of arguments that will be joined together to form the filename:
 
 ```
 > bin/db new-migration user accounts
@@ -28,6 +27,27 @@ together to form the filename:
     app/src/back_end/data_models/migrations/20250508132646_user-accounts.rb
 ```
 
+If you will be creating [database models](/database-access) as well, you may find it
+easier to use `bin/scaffold db_model`, which will create an empty database model
+class, empty test, and empty factory, along with an outline of your migration:
+
+```
+bin/scaffold db_model widget
+[ bin/scaffold ] Executing ["bin/db new_migration create_widget"]
+[ bin/db ] Migration created:
+    app/src/back_end/data_models/migrations/20250712182257_create_widgets.rb
+[ bin/scaffold ] ["bin/db new_migration create_widgets"] succeeded
+[ bin/scaffold ] Creating DB::Foo in app/src/back_end/data_models/db/widget.rb
+[ bin/scaffold ] Creating spec for DB::Foo in specs/back_end/data_models/db/widget.spec.rb
+[ bin/scaffold ] Creating factory for DB::Foo in specs/factories/db/widget.factory.rb
+```
+
+> [!IMPORTANT]
+> Brut doesn't do pluralization logic.  Although Sequel does do some, you should
+> not refer to your database model plurally. If you were do run `bin/scaffold
+> db_model widgets`, you'd create the class `DB::Widgets`, which would not work.
+> Be aware.
+
 Note that the files are located in `app/src/back_end/data_models/migrations` and
 have a name prefixed with a timestamp.  This timestamp determins an ordering of how
 the files are applied to the database.

data/brutrb.com/dev-environment.md

@@ -107,6 +107,7 @@ you full documentation about what the command and subcommands do.
 |                 | `custom_element_test` | Create a test for a custom element in your app                                            |
 |                 | `form`                | Create a form and handler                                                                 |
 |                 | `page`                | Create a new page and associated test                                                     |
+|                 | `db_model`            | Create one or more database models, specs, and factories, plus a migration to create the tables for those models |
 |                 | `test`                | Create the shell of a unit test based on an existing source file                          |
 |                 | `test:e2e`            | Create the shell of an end-to-end test                                                    |
 | <code style="white-space: nowrap">bin/test</code>      |                       | Run tests |

data/brutrb.com/form-constraints.md

@@ -31,7 +31,7 @@ form.server_side_constraint_violation(
 ```
 
 The `input_name` is the same value you used when creating your form class, and `key`
-is an [I18n](/i18n) key that will have `cv.be` prepended to it (for **c*onstratin **v**iolation, **b**ack **e**nd).  Thus, the key in the above example is `"cv.be.name_is_taken"`.
+is an [I18n](/i18n) key that will have `cv.ss` prepended to it (for **c*onstratin **v**iolation, **s**server **s**ide).  Thus, the key in the above example is `"cv.ss.name_is_taken"`.
 
 Brut forms will automatically add client-side constraints based on the value
 assigned to the input.  For example, since `name` must be 3 or more characters, this
@@ -128,7 +128,7 @@ They `key` attribute is for an I18n key that is expected to be on the page insid
 `<brut-i18n-translation>` element.  These are typically included in the [layout](/layouts), and generate HTML like so:
 
 ```html
-<brut-i18n-translation key="cv.fe.rangeUnderflow"
+<brut-i18n-translation key="cv.cs.rangeUnderflow"
                        value="%{field} is too short"></brut-i18n-translation>
 ```
 

data/brutrb.com/handlers.md

@@ -51,7 +51,7 @@ class NewWidgetHandler < AppHandler
 
   def handle
     # if no client-side violations were submitted
-    if !@form.constraint_violations?
+    if @form.valid?
       widget = DB::Widget.find(name: form.name)
       if widget
         @form.server_side_constraint_violation(

data/brutrb.com/i18n.md

@@ -155,14 +155,14 @@ error.
 If included, it will work as normal:
 
 ```ruby
-t("cv.be.required", field: "Email") # => Email is required
+t("cv.ss.required", field: "Email") # => Email is required
 ```
 
 If omitted, the value of `"cv.this_field"` is used. This is included in `1_default.rb`, but if it's
 missing, Brut will raise.  Assuming the value is `"This field"`:
 
 ```ruby
-t("cv.be.required") # => This field is required
+t("cv.ss.required") # => This field is required
 ```
 
 ## Testing

data/brutrb.com/layouts.md

@@ -35,7 +35,7 @@ class DefaultLayout < Brut::FrontEnd::Layout
         script(defer: true, src: asset_path("/js/app.js"))
         title { app_name }
         PageIdentifier(@page_name)
-        I18nTranslations("cv.fe")
+        I18nTranslations("cv.cs")
         I18nTranslations("cv.this_field")
         Traceparent()
         render(

data/brutrb.com/recipes/migrations.md

@@ -0,0 +1,210 @@
+# Migration Example
+
+If you've not used [Sequel](https://sequel.jeremyevans.net/) before, this recipe will show you the basics of creating [migrations](https://sequel.jeremyevans.net/rdoc/files/doc/migration_rdoc.html),
+which are how the database schema is managed in Brut.
+
+## Feature
+
+* An accounts table will store an email and a deactivated date
+* A blog posts table will store a title and content, and be attributed to an
+account.
+
+## Recipe
+
+We'll create the migration, create data models, create and lint factories, then create seed data.
+
+### Create the Migration
+
+Create the migration file with `bin/db new_migration`:
+
+```
+> bin/db new_migration Accounts and Blog Posts
+[ bin/db ] Migration created:
+   app/src/back_end/data_models/migrations/20250711215310_Accounts-and-Blog-Posts.rb
+```
+
+> [!NOTE]
+> Your filename will be different, since it embeds a timestamp for when `bin/db new_migration` was run.
+
+Now, use Sequel's migrations API, keeping in mind [Brut's augmentations](/database-schema), to create our tables.
+
+Our tables will use [an external ids](/database-schema#external-ids).  Note that
+Brut will ensure both tables have primary keys and have `created_at` fields.
+
+```ruby
+# app/src/back_end/data_models/migrations/20250711215310_Accounts-and-Blog-Posts.rb
+Sequel.migration do
+  up do
+    create_table :accounts,
+                  comment: "People or systems who can access this system",
+                  external_id: true do
+
+      column :email,          :text, unique: true
+      column :deactivated_at, :timestamptz, null: true
+
+    end
+    
+    create_table :blog_posts,
+                  comment: "Posts on our amazing blog",
+                  external_id: true do
+
+      column :title, :text
+      column :content, :text
+
+      foreign_key :account_id, :accounts
+    end
+  end
+end
+```
+
+You can apply this migration with `bin/db migrate`:
+
+```
+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`
+
+> [!NOTE]
+> There is no down migration. If you need to change and re-apply this before
+> you have promoted it to production, rebuild your dev database with `bin/db
+> rebuild`.  It will apply all migrations from a fresh, empty database.
+
+You can examine the tables with `psql`, via `bin/dbconsole`:
+
+```
+> bin/dbconsole
+development=# \d accounts
+                                       Table "public.accounts"
+     Column     |           Type           | Collation | Nullable |             Default              
+----------------+--------------------------+-----------+----------+----------------------------------
+ id             | integer                  |           | not null | generated by default as identity
+ email          | text                     |           | not null | 
+ deactivated_at | timestamp with time zone |           |          | 
+ created_at     | timestamp with time zone |           | not null | 
+ external_id    | citext                   |           | not null | 
+Indexes:
+    "accounts_pkey" PRIMARY KEY, btree (id)
+    "accounts_email_key" UNIQUE CONSTRAINT, btree (email)
+    "accounts_external_id_key" UNIQUE CONSTRAINT, btree (external_id)
+Referenced by:
+    TABLE "blog_posts" CONSTRAINT "blog_posts_account_id_fkey" FOREIGN KEY (account_id) REFERENCES accounts(id)
+
+development=# \d blog_posts
+                                    Table "public.blog_posts"
+   Column    |           Type           | Collation | Nullable |             Default              
+-------------+--------------------------+-----------+----------+----------------------------------
+ id          | integer                  |           | not null | generated by default as identity
+ title       | text                     |           | not null | 
+ content     | text                     |           | not null | 
+ account_id  | integer                  |           | not null | 
+ created_at  | timestamp with time zone |           | not null | 
+ external_id | citext                   |           | not null | 
+Indexes:
+    "blog_posts_pkey" PRIMARY KEY, btree (id)
+    "blog_posts_account_id_index" btree (account_id)
+    "blog_posts_external_id_key" UNIQUE CONSTRAINT, btree (external_id)
+Foreign-key constraints:
+    "blog_posts_account_id_fkey" FOREIGN KEY (account_id) REFERENCES accounts(id)
+```
+
+Note that all columns are `NOT NULL` except `deactivated_at`, which we explicitly
+set as nullable.  Note that the foreign key on `account_id` has an index and is
+non-nullable.  And note that both tables have `external_id` and `created_at`
+columns. Brut will manage their contents.
+
+### Create Data Models
+
+Brut doesn't create your data models for you, since it assumes you prefer writing
+code in your editor and not on the command line.  Your data models will initially be
+pretty short.
+
+```ruby
+# app/src/back_end/data_models/db/account.rb
+class DB::Account < AppDataModel
+  has_external_id :ac
+  one_to_many :blog_posts
+end
+
+# app/src/back_end/data_models/db/blog_post.rb
+class DB::BlogPost < AppDataModel
+  many_to_one :account
+end
+```
+
+You can run `bin/console` to try to test these, but it's easier to create factories
+and use the `specs/lint_factories.spec.rb` to do that for us.
+
+### Create Factories
+
+Factories go in `specs/factories/db` and have a `.factory.db` suffix:
+
+```ruby
+# specs/factories/db/account.factory.rb
+FactoryBot.define do
+  factory :account, class: "DB::Account" do
+    email         { Faker::Internet.unique.email }
+
+    trait :inactive do
+      deactivated_at { Time.now }
+    end
+  end
+end
+
+# specs/factories/db/blog_post.factory.rb
+FactoryBot.define do
+  factory :blog_post, class: "DB::BlogPost" do
+    title { Faker::Lorem.sentence }
+    content { Faker::Lorem.paragraphs.join("\n\n") }
+
+    account
+  end
+end
+```
+
+Note that the blog post factory creates an account.  This is so that
+`create(:blog_post)` will always succeeed in creating valid data.
+
+To prove it, we'll lint our factories:
+
+```
+bin/test run specs/lint_factories.spec.rb
+```
+
+This will create every combination of every factory and fail if doing so raises an
+error.
+
+### Create Seed Data
+
+Now, we'll set up seed data.  `mkbrut` should've created
+`app/src/back_end/data_models/seed/seed_data.rb`, so we'll use that.
+
+```ruby
+require "brut/back_end/seed_data"
+class SeedData < Brut::BackEnd::SeedData
+  include FactoryBot::Syntax::Methods
+  def seed!
+    pat   = create(:account,            email: "pat@example.com")
+    chris = create(:account, :inactive, email: "chris@example.com")
+
+    5.times do
+      create(:blog_post, account: pat)
+      create(:blog_post, account: chris)
+    end
+  end
+end
+```
+
+We can apply this with `bin/db seed`:
+
+```
+bin/db seed
+```
+
+> [!IMPORTANT]
+> `bin/db rebuild` will *not* apply seed data, however `bin/setup` should.
+> For now, if you want to totally reset your database, you will need to do `bin/db
+> rebuild && bin/db seed && bin/db rebuild -e test`

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._UukLsdv.js"></script>
+    <script type="module" src="/assets/app.AkS4fHzI.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\":\"JRxZ5uYE\",\"ai.md\":\"Cy9GWnER\",\"assets.md\":\"7C3HWkga\",\"brut-js.md\":\"B4GYxQVw\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"CjsktgFz\",\"components.md\":\"DP8maNoF\",\"configuration.md\":\"BDXwuZHU\",\"css.md\":\"CltvJqAa\",\"custom-element-tests.md\":\"B_rbta32\",\"database-access.md\":\"gnluu54N\",\"database-schema.md\":\"CSYk6E6v\",\"deployment.md\":\"BLseERGV\",\"dev-environment.md\":\"Dy6EldaM\",\"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\":\"x5tNpTTI\",\"forms.md\":\"BwBNYrrL\",\"getting-started.md\":\"B4LlHfav\",\"handlers.md\":\"Chyri6KA\",\"hooks.md\":\"Jmb5VOLA\",\"i18n.md\":\"xQhiGo1G\",\"index.md\":\"Bn9e0sRJ\",\"instrumentation.md\":\"BgcaGVYH\",\"javascript.md\":\"DzrMxUmI\",\"jobs.md\":\"S-2amAYp\",\"keyword-injection.md\":\"95Zgh2eN\",\"layouts.md\":\"CJGDFY-m\",\"lsp.md\":\"Dn1rIiW0\",\"markdown-examples.md\":\"CCFEQO44\",\"middleware.md\":\"Czz_UlJN\",\"overview.md\":\"iMnwLO4x\",\"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_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\":\"BYXj4cOu\",\"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\":\"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\":\"JRxZ5uYE\",\"ai.md\":\"Cy9GWnER\",\"assets.md\":\"7C3HWkga\",\"brut-js.md\":\"B4GYxQVw\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"CjsktgFz\",\"components.md\":\"BfeWD9sX\",\"configuration.md\":\"DoSBNc0H\",\"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\":\"DFveP5g_\",\"getting-started.md\":\"DZWjCVC0\",\"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\":\"iMnwLO4x\",\"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\":\"BYXj4cOu\",\"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>