brut 0.4.0 → 0.8.0

data/brut-js/package.json

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

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

@@ -10,7 +10,7 @@ describe("<brut-ajax-submit>", () => {
       </brut-ajax-submit>
     </form>
   `).onFetch( "/foo", [
-    { then: { status: 200 }},
+    { then: { status: 200, text: "<div>some html</div>" }},
   ]
   ).test("submits the form, setting various attributes during the lifecycle", 
          ({document,assert,fetchRequests,waitForSetTimeout,readRequestBodyIntoString}) => {
@@ -21,8 +21,10 @@ describe("<brut-ajax-submit>", () => {
     const number  = document.querySelector("input[name=some-number]")
 
     let okReceived = false
-    element.addEventListener("brut:submitok", () => {
+    let detailReceived = null
+    element.addEventListener("brut:submitok", (event) => {
       okReceived = true
+      detailReceived = event.detail
     })
 
     text.value   = "Some Text"
@@ -37,6 +39,8 @@ describe("<brut-ajax-submit>", () => {
 
     return Promise.all(promises).then( () => {
       assert(okReceived)
+      assert(detailReceived)
+      assert.equal(detailReceived.body.innerHTML,"<div>some html</div>")
       assert(element.getAttribute("requesting") == null)
       assert(element.getAttribute("submitted") != null)
       waitForSetTimeout(11).then( () => {
@@ -58,7 +62,7 @@ describe("<brut-ajax-submit>", () => {
     const number  = form.querySelector("input[name=some-number]")
 
     let okReceived = false
-    element.addEventListener("brut:submitok", () => {
+    element.addEventListener("brut:submitok", (event) => {
       okReceived = true
     })
 
@@ -204,16 +208,22 @@ Error that should be ignored
       }
     },
   ]
-  ).test("when we get a 422, parses the result from the server", ({document,window,assert,fetchRequests,waitForSetTimeout}) => {
+  ).test("when we get a 422, parses the result from the server and inserts them into the DOM, event detail is null", ({document,window,assert,fetchRequests,waitForSetTimeout}) => {
     const form    = document.querySelector("form")
     const element = form.querySelector("brut-ajax-submit")
     const button  = element.querySelector("button")
     const text    = form.querySelector("input[name=some-text]")
     const number  = form.querySelector("input[name=some-number]")
 
-    let okReceived = 0
+    let okReceived = false
+    let submittedInvalidReceived = false
+    let submittedInvalidDetail = "not null"
     element.addEventListener("brut:submitok", () => {
-      okReceived++
+      okReceived = true
+    })
+    element.addEventListener("brut:submitinvalid", (event) => {
+      submittedInvalidReceived = true
+      submittedInvalidDetail = event.detail
     })
 
     text.value   = "Some Text"
@@ -227,7 +237,9 @@ Error that should be ignored
         map( (fetchRequest) => fetchRequest.promiseReturned )
 
       return Promise.all(promises).then( () => {
-        assert.equal(okReceived,0)
+        assert(!okReceived)
+        assert( submittedInvalidReceived)
+        assert(!submittedInvalidDetail)
         const textFieldErrors = form.querySelectorAll("brut-cv-messages[input-name='some-text'] brut-cv")
         assert.equal(3,textFieldErrors.length) // prevous client-side and 2 new server-side
         const serverSideTextFieldErrors = form.querySelectorAll("brut-cv-messages[input-name='some-text'] brut-cv[server-side]")
@@ -253,4 +265,85 @@ Error that should be ignored
       })
     })
   })
+  withHTML(`
+    <form action="http://example.net/foo" method="POST">
+
+      <input required type="text" name="some-text">
+      <brut-cv-messages input-name="some-text">
+        <brut-cv input-name="some-text">
+        A client-side-error
+        </brut-cv>
+        <brut-cv server-side input-name="some-text">
+        A previous server-side-error
+        </brut-cv>
+      </brut-cv-messages>
+
+      <input required type="number" name="some-number">
+      <brut-cv-messages input-name="some-number">
+      </brut-cv-messages>
+
+      <brut-ajax-submit submitted-lifetime="10" no-server-side-error-parsing>
+        <button>Submit</button>
+      </brut-ajax-submit>
+    </form>
+  `).onFetch( "/foo", [
+    {
+      then: {
+        status: 422,
+        text: `
+<brut-cv input-name="some-text">
+A sever-side error
+</brut-cv>
+<brut-cv input-name="some-text">
+Another sever-side error
+</brut-cv>
+<brut-cv input-name="some-other-text">
+Irrelevant server-side error
+</brut-cv>
+<brut-cv>
+Error that should be ignored
+</brut-cv>
+<div>element that should be ignored</div>
+        `
+      }
+    },
+  ]
+  ).test("when we get a 422, does not parse the results, but includes them in the detail", ({document,window,assert,fetchRequests,waitForSetTimeout}) => {
+    const form    = document.querySelector("form")
+    const element = form.querySelector("brut-ajax-submit")
+    const button  = element.querySelector("button")
+    const text    = form.querySelector("input[name=some-text]")
+    const number  = form.querySelector("input[name=some-number]")
+
+    let okReceived = false
+    let submittedInvalidReceived = false
+    let submittedInvalidDetail = null
+    element.addEventListener("brut:submitok", () => {
+      okReceived = true
+    })
+    element.addEventListener("brut:submitinvalid", (event) => {
+      submittedInvalidReceived = true
+      submittedInvalidDetail = event.detail
+    })
+
+    text.value   = "Some Text"
+    number.value = "11"
+
+    button.click()
+    return waitForSetTimeout(5).then( () => {
+
+      const promises = fetchRequests.
+        filter( (fetchRequest) => fetchRequest.promiseReturned ).
+        map( (fetchRequest) => fetchRequest.promiseReturned )
+
+      return Promise.all(promises).then( () => {
+        assert(!okReceived)
+        assert( submittedInvalidReceived)
+        assert.equal(submittedInvalidDetail.body.children.length,5)
+        const textFieldErrors = form.querySelectorAll("brut-cv-messages[input-name='some-text'] brut-cv")
+        assert.equal(2,textFieldErrors.length) // what was initially rendered
+
+      })
+    })
+  })
 })

data/brut-js/src/AjaxSubmit.js

@@ -13,7 +13,13 @@ import ConstraintViolationMessage from "./ConstraintViolationMessage"
  * 4. If the request returns OK:
  *    - `requesting` will be removed and `submitted` will be added.
  *    - `submitted` will be removed after `submitted-lifetime` ms.
- * 5. If the request returned a 422, error messages are parsed. See below.
+ *    - the `brut:submitok` event will be fired with the response text, **parsed as HTML**, as `event.detail`.
+ * 5. If the request returned a 422:
+ *    - If you have set `no-server-side-error-parsing`, the results will be included in the 
+ *      detail field of the `brut:submitinvalid` event.
+ *    - If you have NOT set `no-server-side-error-parsing`, the response is parsed as
+ *      errors to be inserted into the DOM.  See below for how that works.  In this case,
+ *      `brut:submitinvalid`'s detail bill be null.
  * 6. If the request returns not OK and not 422:
  *    - if it has been `request-timeout` ms or more since the button was first clicked, the operation is aborted (see below).
  *    - if it has been less than `request-timeout` ms and the HTTP status code was 5xx, the operation is retried.
@@ -23,7 +29,8 @@ import ConstraintViolationMessage from "./ConstraintViolationMessage"
  * Aborting the operation will submit the form in the normal way, allowing the browser to deal with whatever the issue is. You can set
  * `log-request-errors` to introspect this process.
  *
- * For a 422 response, this element assumes the response is `text/html` and contains one or more `<brut-cv>`
+ * For a 422 response (where `no-server-side-error-parsing` is *not* set),
+ * this element assumes the response is `text/html` and contains one or more `<brut-cv>`
  * elements.  These elements will be inserted into the proper `<brut-cv-messages>` element, as follows:
  *
  * 1. The `input-name` is examined.
@@ -37,6 +44,17 @@ import ConstraintViolationMessage from "./ConstraintViolationMessage"
  * 9. The first input located is scrolled into view
  * 10. If the input is modified after this all happens, custom validity is cleared
  *
+ * For the server you are contacting, this element has a few requirements:
+ *
+ * - If everything is OK/the operation did what it was intended to do:
+ *   - the server will respond with a 2xx
+ *   - the response body, if it contains anything, be `text/html` (this is provided in the event detail)
+ * - If there are server-side constraint violations.
+ *   - the server will return 422
+ *   - the response body will be `text/html`
+ *   - the response body will contain one or more `<brut-cv>` elements
+ *
+ * @property {boolean} no-server-side-error-parsing - if set, the response body for a 422 will not be parsed and inserted into the DOM. Instead, the body will be part of the detail of the `brut:submitinvalid` event.
  * @property {number} request-timeout - number of ms that the entire operation is expected to complete within. Default is 5000
  * @property {number} submitted-lifetime - number of ms that "submitted" should remain on the element after the form has completed. Default is 2000
  * @property {boolean} requesting - boolean attribute that indicates the request has been made, but not yet returned. Don't set this yourself outside of development. It will be set and removed by this element.
@@ -44,8 +62,8 @@ import ConstraintViolationMessage from "./ConstraintViolationMessage"
  * @property {boolean} log-request-errors - if set, logging related to request error handling will appear in the console. It will also
  * cause any form submission to be delayed by 2s to allow you to read the console.
  *
- * @fires brut:submitok Fired when the AJAX request initated by this returns OK and all processing has completed
- * @fires brut:submitinvalid Fired when the AJAX request initated by this returns a 422 and all logic around managing the reponse has completed
+ * @fires brut:submitok Fired when the AJAX request initated by this returns OK and all processing has completed. The detail will include the *parsed document* of the HTML returned in the response.
+ * @fires brut:submitinvalid Fired when the AJAX request initated by this returns a 422 and all logic around managing the reponse has completed. The detail will be null unless `no-server-side-error-parsing` is set, in which case it will be the parsed document of the HTML returned in the response.
  *
  * @example
  * <form action="/widgets" method="post">
@@ -68,6 +86,7 @@ class AjaxSubmit extends BaseCustomElement {
     "request-timeout",
     "max-retry-attempts",
     "log-request-errors",
+    "no-server-side-error-parsing",
   ]
 
   #requestErrorLogger = () => {}
@@ -75,6 +94,12 @@ class AjaxSubmit extends BaseCustomElement {
   #submittedLifetime  = 2000
   #requestTimeout     = 5000
   #maxRetryAttempts   = 25
+  #serverSideErrorParsing = true
+
+  constructor() {
+    super()
+    this.domParser = new DOMParser()
+  }
 
   submittedLifetimeChangedCallback({newValue}) {
     const newValueAsInt = parseInt(newValue)
@@ -84,6 +109,10 @@ class AjaxSubmit extends BaseCustomElement {
     this.#submittedLifetime = newValueAsInt
   }
 
+  noServerSideErrorParsingChangedCallback({newValueAsBoolean}) {
+    this.#serverSideErrorParsing = !newValueAsBoolean
+  }
+
   maxRetryAttemptsChangedCallback({newValue}) {
     const num = parseInt(newValue)
     if (isNaN(num)) {
@@ -187,7 +216,10 @@ class AjaxSubmit extends BaseCustomElement {
         this.setAttribute("submitted",true)
 
         setTimeout( () => this.removeAttribute("submitted"), this.#submittedLifetime )
-        this.dispatchEvent(new CustomEvent("brut:submitok"))
+        response.text().then( (text) =>  {
+          const parsedDocument = this.domParser.parseFromString(text,"text/html")
+          this.dispatchEvent(new CustomEvent("brut:submitok", { detail: parsedDocument }))
+        })
       }
       else {
 
@@ -250,49 +282,53 @@ class AjaxSubmit extends BaseCustomElement {
   #handleConstraintViolations(response) {
     let resubmit = false
     response.text().then( (text) => {
-      try {
-        const inputsToMessages = ErrorMessagesForInput.mapInputsToErrorMessages(
-          this.#errorMessagesFromServer(text),
-          this.#requestErrorLogger
-        )
+      const parsedDocument = this.domParser.parseFromString(text,"text/html")
+      let event
+      if (this.#serverSideErrorParsing) {
+        event = new CustomEvent("brut:submitinvalid")
+      }
+      else {
+        event = new CustomEvent("brut:submitinvalid", { detail: parsedDocument })
+      }
+      this.dispatchEvent(event)
+      if (this.#serverSideErrorParsing) {
+        const constraintViolationNodes = parsedDocument.querySelectorAll(ConstraintViolationMessage.tagName)
+        try {
+          const inputsToMessages = ErrorMessagesForInput.mapInputsToErrorMessages(
+            constraintViolationNodes,
+            this.#requestErrorLogger
+          )
+
+          let inputToScrollToAfterReportingValidity
+          for (const [inputName, {input, messagesElement, errorMessages}] of Object.entries(inputsToMessages)) {
+            if (!inputToScrollToAfterReportingValidity) {
+              inputToScrollToAfterReportingValidity = input
+            }
+            messagesElement.clearServerSideMessages()
+            errorMessages.forEach( (element) => {
+              ConstraintViolationMessage.markServerSide(element)
+              messagesElement.appendChild(element) 
+            })
+            this.#setCustomValidityThatClearsOnChange(input,errorMessages)
+          }
 
-        let inputToScrollToAfterReportingValidity
-        for (const [inputName, {input, messagesElement, errorMessages}] of Object.entries(inputsToMessages)) {
-          if (!inputToScrollToAfterReportingValidity) {
-            inputToScrollToAfterReportingValidity = input
+          if (inputToScrollToAfterReportingValidity) {
+            inputToScrollToAfterReportingValidity.scrollIntoView()
           }
-          messagesElement.clearServerSideMessages()
-          errorMessages.forEach( (element) => {
-            ConstraintViolationMessage.markServerSide(element)
-            messagesElement.appendChild(element) 
-          })
-          this.#setCustomValidityThatClearsOnChange(input,errorMessages)
+          resubmit = false
+          this.removeAttribute("requesting")
         }
-
-        if (inputToScrollToAfterReportingValidity) {
-          inputToScrollToAfterReportingValidity.scrollIntoView()
+        catch (e) {
+          this.#requestErrorLogger("While parsing %s, got %s", text, e)
+          resubmit = true
+        }
+        if (resubmit) {
+          this.#submitFormThroughBrowser(form)
         }
-        resubmit = false
-        this.removeAttribute("requesting")
-        this.dispatchEvent(new CustomEvent("brut:submitinvalid"))
-      }
-      catch (e) {
-        this.#requestErrorLogger("While parsing %s, got %s", text, e)
-        resubmit = true
-      }
-      if (resubmit) {
-        this.#submitFormThroughBrowser(form)
       }
     })
   }
 
-  #errorMessagesFromServer(text) {
-    const parser   = new DOMParser()
-    const fragment = parser.parseFromString(text,"text/html")
-
-    return fragment.querySelectorAll(ConstraintViolationMessage.tagName)
-  }
-
   #setCustomValidityThatClearsOnChange(input,errorMessages) {
     input.setCustomValidity(errorMessages[0].textContent)
     input.reportValidity()

data/brut.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["David Bryant Copeland"]
   spec.email         = ["davec@thirdtank.com"]
 
-  spec.summary       = %q{NOT YET RELEASED - Web Framework Built around Ruby, Web Standards, Simplicity, and Object-Orientation}
-  spec.description   = %q{NOT YET RELEASED - An opinionated web framework build on web standards}
+  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"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'

data/brutrb.com/adrs.md

@@ -13,3 +13,4 @@ them, and mostly hold up.
 * [Brut will not provider mailers, cloud storage, or background jobs](https://adrs.cloud/shared_adrs/padr_e7078d29f00710848ebbe43aea6094a6)
 * [Requiring files should not execute code](https://adrs.cloud/shared_adrs/padr_03b5cf8e34bb7900a38f6de27e50adaa)
 * [Phlex will be used for HTML templating](https://adrs.cloud/shared_adrs/padr_9529a5ada671254b5e5865b45abde92d)
+* [RSpec is the default testing framework](https://adrs.cloud/shared_adrs/padr_724a65340d734970ea222593a4a2760f)

data/brutrb.com/bin/setup

@@ -2,4 +2,5 @@
 
 set -e
 
+echo "[ brutrb.com/bin/setup ] Setting up BrutJS"
 npm install

data/brutrb.com/getting-started.md

@@ -11,6 +11,7 @@ The simplest way to use `mkbrut` is to use an existing [Docker image](https://hu
 docker run \
        -v "$PWD":"$PWD" \
        -w "$PWD" \
+       -u $(id -u):$(id -g) \
        -it \
        thirdtank/mkbrut \
        mkbrut my-new-app
@@ -34,6 +35,7 @@ For now:
 docker run \
        -v "$PWD":"$PWD" \
        -w "$PWD" \
+       -u $(id -u):$(id -g) \
        -it \
        thirdtank/mkbrut \
        mkbrut my-new-app
@@ -55,6 +57,7 @@ To create your app without the demo components:
 docker run \
        -v "$PWD":"$PWD" \
        -w "$PWD" \
+       -u $(id -u):$(id -g) \
        -it \
        thirdtank/mkbrut \
        mkbrut my-new-app --no-demo

data/brutrb.com/overview.md

@@ -20,6 +20,12 @@ more aestheticly pleasing form. You already need to know CSS, HTML, the Web
 Platform, and SQL, so there's little to gain by requiring you to learn a different
 way to use them.
 
+## Yes, You Can Build a Blog in 15 Minutes
+
+<iframe title="Make a Blog App in 15(ish) minutes With BrutRB - A New Ruby Web Framework" width="560" height="315" src="https://video.hardlimit.com/videos/embed/ae7EMhwjDq9kSH5dqQ9swV" frameborder="0" allowfullscreen="" sandbox="allow-same-origin allow-scripts allow-popups allow-forms"></iframe>
+
+[Check out the source code](https://github.com/thirdtank/blog-demo) if you want to dive right in.
+
 ## Basic Elements
 
 Brut organizes its code and behavior around four basic concepts:

data/brutrb.com/tutorial.md

@@ -2,6 +2,10 @@
 
 A real tutorial will appear here eventually.
 
-In the mean time, [ADRs.cloud](https://github.com/thirdtank/adrs.cloud) is a
-full-fledge Brut app you can examine to see how things work. You can be running it
-locally in minutes, once you install Docker.
+There are two apps you can check out in the mean time:
+
+* [A 15-minute Blog](https://github.com/thirdtank/blog-demo) (see [demo video on how this is made](https://video.hardlimit.com/w/ae7EMhwjDq9kSH5dqQ9swV))
+* [ADRs.cloud](https://github.com/thirdtank/adrs.cloud), which is a more realistic app that has
+  mulitple database tables, progressively-enhanced UI, and background jobs.
+
+You can be running either of these locally in minutes as long as you have Docker installed.

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.AkS4fHzI.js"></script>
+    <script type="module" src="/assets/app.DyQLb4Ot.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\":\"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>
+    <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>
     
   </body>
 </html>