ValidateRequiredFields [step] v1.0.0

signature: (form: HTMLFormElement | FormDataObject) -> ValidationResult effect: read-only

Errors

• InvalidFormElement
• NoFieldsFound

Meta

• License: Apache-2.0
• License Provenance: package-authorship-claim

Body

    For each field F in form.fields:
      1. Check `required` attribute or `data-required` flag.
      2. If required AND F.value is empty (undefined, null, "", or whitespace-only):
           record violation:
             { field-id: F.id, field-name: F.name, message: localizedMessage(F, 'required') }
      3. If F has `pattern` attribute AND F.value does not match:
           record violation with message from F.dataset.patternError or default.
      4. If F.type == 'email' AND F.value does not match RFC-5322-compatible regex:
           record violation.
      5. If F has `minlength` AND F.value.length < minlength:
           record violation.

    Aggregation rules:
      - For each violation, set ARIA: F.setAttribute('aria-invalid', 'true')
        and link to error message via F.setAttribute('aria-describedby', errorId).
      - Move keyboard focus to the FIRST violating field on submit attempt.
      - Announce summary via aria-live="assertive" region: "5 errors prevented submission. First error: ..."
      - Inline error message must be visually adjacent to the field (NOT only in a top banner).

    Return ValidationResult = {
      valid: boolean,            // true iff no violations
      violations: Violation[],   // ordered by DOM order
      first-invalid: HTMLElement | null
    }
  

Preconditions

• form has been initialized in the DOM with semantic // elements</li> <li>each field has an associated <label> (see @community/check-form-label-associated)</li> </ul> <h2>Postconditions</h2> <ul> <li>valid fields have aria-invalid='false' or attribute removed</li> <li>invalid fields have aria-invalid='true' and aria-describedby pointing at error message id</li> <li>focus has moved to first invalid field if any</li> </ul> </div> </div> <div class="proj-panel" data-panel="full" hidden data-astro-cid-ztpy2nk5> <p class="proj-when" data-astro-cid-ztpy2nk5>Loaded when retrieval picks the atom as a focal / direct hit.</p> <div class="atom-prose" data-astro-cid-ztpy2nk5><h1>ValidateRequiredFields [step] v1.0.0</h1> <p>signature: (form: HTMLFormElement | FormDataObject) -> ValidationResult effect: read-only</p> <h2>Errors</h2> <ul> <li>InvalidFormElement</li> <li>NoFieldsFound</li> </ul> <h2>Meta</h2> <ul> <li><strong>License</strong>: Apache-2.0</li> <li><strong>License Provenance</strong>: package-authorship-claim</li> </ul> <h2>Body</h2> <pre><code> For each field F in form.fields: 1. Check `required` attribute or `data-required` flag. 2. If required AND F.value is empty (undefined, null, "", or whitespace-only): record violation: { field-id: F.id, field-name: F.name, message: localizedMessage(F, 'required') } 3. If F has `pattern` attribute AND F.value does not match: record violation with message from F.dataset.patternError or default. 4. If F.type == 'email' AND F.value does not match RFC-5322-compatible regex: record violation. 5. If F has `minlength` AND F.value.length < minlength: record violation. Aggregation rules: - For each violation, set ARIA: F.setAttribute('aria-invalid', 'true') and link to error message via F.setAttribute('aria-describedby', errorId). - Move keyboard focus to the FIRST violating field on submit attempt. - Announce summary via aria-live="assertive" region: "5 errors prevented submission. First error: ..." - Inline error message must be visually adjacent to the field (NOT only in a top banner). Return ValidationResult = { valid: boolean, // true iff no violations violations: Violation[], // ordered by DOM order first-invalid: HTMLElement | null } </code></pre> <h2>Preconditions</h2> <ul> <li>form has been initialized in the DOM with semantic <input>/<select>/<textarea> elements</li> <li>each field has an associated <label> (see @community/check-form-label-associated)</li> </ul> <h2>Postconditions</h2> <ul> <li>valid fields have aria-invalid='false' or attribute removed</li> <li>invalid fields have aria-invalid='true' and aria-describedby pointing at error message id</li> <li>focus has moved to first invalid field if any</li> </ul> <h2>Relations</h2> <p>related: [@community/step-debounce-search-input, @community/check-form-validation-inline, @community/check-form-label-associated, @community/rule-actionable-error-messages, @community/category-form-input-states]</p> <h2>Errors</h2> <ul> <li>InvalidFormElement</li> <li>NoFieldsFound</li> </ul> <h2>Meta</h2> <ul> <li><strong>License</strong>: Apache-2.0</li> <li><strong>License Provenance</strong>: package-authorship-claim</li> </ul> <h2>Body</h2> <pre><code> For each field F in form.fields: 1. Check `required` attribute or `data-required` flag. 2. If required AND F.value is empty (undefined, null, "", or whitespace-only): record violation: { field-id: F.id, field-name: F.name, message: localizedMessage(F, 'required') } 3. If F has `pattern` attribute AND F.value does not match: record violation with message from F.dataset.patternError or default. 4. If F.type == 'email' AND F.value does not match RFC-5322-compatible regex: record violation. 5. If F has `minlength` AND F.value.length < minlength: record violation. Aggregation rules: - For each violation, set ARIA: F.setAttribute('aria-invalid', 'true') and link to error message via F.setAttribute('aria-describedby', errorId). - Move keyboard focus to the FIRST violating field on submit attempt. - Announce summary via aria-live="assertive" region: "5 errors prevented submission. First error: ..." - Inline error message must be visually adjacent to the field (NOT only in a top banner). Return ValidationResult = { valid: boolean, // true iff no violations violations: Violation[], // ordered by DOM order first-invalid: HTMLElement | null } </code></pre> <h2>Preconditions</h2> <ul> <li>form has been initialized in the DOM with semantic <input>/<select>/<textarea> elements</li> <li>each field has an associated <label> (see @community/check-form-label-associated)</li> </ul> <h2>Postconditions</h2> <ul> <li>valid fields have aria-invalid='false' or attribute removed</li> <li>invalid fields have aria-invalid='true' and aria-describedby pointing at error message id</li> <li>focus has moved to first invalid field if any</li> </ul> </div> </div> </section> <section class="atom-section" data-astro-cid-ztpy2nk5> <header class="atom-section-h" data-astro-cid-ztpy2nk5> <h2 data-astro-cid-ztpy2nk5>Source</h2> <span class="atom-section-meta" data-astro-cid-ztpy2nk5>where the compiled artifact came from</span> </header> <pre class="atom-source" data-astro-cid-ztpy2nk5><code data-astro-cid-ztpy2nk5>aoe-engine/examples/frontend-design/primes/compiled/@community/step-validate-required-fields/atom.yaml</code></pre> </section> </main> <aside class="atom-side" aria-label="Edges and graph" data-astro-cid-ztpy2nk5> <div class="atom-side-card" data-astro-cid-ztpy2nk5> <p class="atom-empty" data-astro-cid-ztpy2nk5>No edges declared.</p> </div> </aside> </div> <nav class="atom-foot" data-astro-cid-ztpy2nk5> <a href="/browse?corpus=frontend-design" data-astro-cid-ztpy2nk5>← Back to @community</a> <a href="/marketplace" data-astro-cid-ztpy2nk5>All Skills →</a> </nav> </div> </main> <footer class="site-footer"> <div class="site-footer-inner"> <div class="footer-brand"> <a class="brand" href="/"> <svg class="brand-mark" viewBox="0 0 64 64" aria-hidden="true"> <circle cx="32" cy="32" r="30" fill="currentColor"></circle> <circle cx="32" cy="32" r="15" fill="none" stroke="var(--bg-canvas)" stroke-width="2.6"></circle> <circle cx="32" cy="32" r="5.5" fill="var(--bg-canvas)"></circle> <path d="M32 17V8M32 56v-9M17 32H8M56 32h-9" stroke="var(--bg-canvas)" stroke-width="2.6" stroke-linecap="round"></path> </svg> <span>AOE</span> </a> <p>AOE is an Agent Ontology Engine that compiles external domain models and corpora into verified runtimes for agents and applications.</p> <p class="label">Apache-2.0 licensed</p> </div> <div> <h4>Start</h4> <ul> <li><a href="/docs">Docs</a></li> <li><a href="/docs/start/connect-agent">Connect an Agent</a></li> <li><a href="/marketplace">Packages</a></li> </ul> </div> <div> <h4>Build</h4> <ul> <li><a href="/docs/concepts/package-model">Package model</a></li> <li><a href="/docs/concepts/compilation-snapshots">Compilation and snapshots</a></li> <li><a href="/docs/concepts/selection-execution">Selection and execution</a></li> </ul> </div> <div> <h4>Project</h4> <ul> <li><a href="/blog">Blog</a></li> <li><a href="/about">About</a></li> <li><a href="https://github.com/kernary-aoe/aoe-engine" rel="noopener">GitHub</a></li> <li><a href="https://github.com/kernary-aoe/aoe-engine/blob/main/LICENSE" rel="noopener">License</a></li> </ul> </div> </div> <div class="footer-wordmark" aria-hidden="true">Agent Ontology Engine</div> <div class="site-footer-bottom"> <span>© 2026 AOE contributors</span> <span>Domain knowledge, made executable</span> </div> </footer> </body> </html>