docs: add docs for precognition

Author: tobimori

docs/0_general/4_precognition.md

@@ -0,0 +1,52 @@
+---
+title: Precognition
+description: Real-time field validation with HTMX
+---
+
+Precognition enables real-time field validation as users type, providing immediate feedback without requiring a full form submission. This feature is only available when using HTMX mode.
+
+## Prerequisites
+
+1. **HTMX Mode**: Your form must use HTMX mode
+2. **Idiomorph Extension**: Required for DOM morphing
+
+Install [HTMX](https://htmx.org/) and the [Idiomorph extension](https://htmx.org/extensions/idiomorph/).
+
+## Configuration
+
+Enable precognition in your config:
+
+```php
+// site/config/config.php
+
+return [
+  'tobimori.dreamform' => [
+    'mode' => 'htmx',
+    'precognition' => true,
+  ],
+];
+```
+
+## How It Works
+
+- Fields validate automatically as users type or change values
+- Text fields wait 500ms after typing stops before validating
+- Select/radio/checkbox fields validate immediately on change
+- Only the changed field is validated, not the entire form
+- No data is saved during precognitive validation
+
+## Partial Submissions
+
+When precognition is enabled, you can also enable partial submissions:
+
+```php
+// site/config/config.php
+
+return [
+  'tobimori.dreamform' => [
+  	// ...
+    'partialSubmissions' => true,
+  ],
+];
+```
+This automatically saves each field's value as the user fills it out. This helps track progress for abandoned forms and prevents data loss from failed submissions.

docs/5_developers/7_under-the-hood.md

@@ -3,4 +3,28 @@ title: Under the Hood
 description: Technical details about how DreamForm works
 ---
 
-Learn about the internal workings of DreamForm, including the submission lifecycle, validation process, and architecture decisions.
+Learn about the internal workings of DreamForm, including the submission lifecycle, validation process, and architecture decisions.
+
+## Submission Lifecycle
+
+### Regular Submission
+
+1. **Request Reception**: Form receives POST request
+2. **Session Initialization**: Creates or retrieves submission session
+3. **Guard Execution**: Security guards validate the request
+4. **Field Validation**: Each field validates its value
+5. **Hook Execution**: `dreamform.submit:before` hooks run
+6. **Action Processing**: Actions execute in defined order
+7. **Submission Storage**: Data saved to submissions folder
+8. **Success Handling**: Redirects or displays success message
+9. **Hook Completion**: `dreamform.submit:after` hooks run
+
+### Precognition Lifecycle
+
+When precognition is enabled, field validation requests follow a simplified flow:
+
+1. **Precognitive Request**: Receives POST with `?precognition=true` (through HTMX)
+2. **Minimal Guards**: Only precognitive guards execute
+3. **Single Field Validation**: Only the triggering field is validated
+4. **Response Generation**: Returns updated field HTML
+5. **No Side Effects**: No hooks, actions, or data storage