#Approval Request

Approval Request explains why an Agent needs additional authority and collects one bounded permission decision. The host application owns policy evaluation, expiration, persistence, and execution after approval.

npm install @a3s-lab/ui@0.4.0

<section
  class="approval-request"
  data-state="pending"
  aria-labelledby="approval-title"
>
  <header>
    <div>
      <h2 id="approval-title">Allow this command?</h2>
      <p>Reason and impact.</p>
    </div>
  </header>
  <section>Exact resource, command, site, or capability.</section>
  <form>
    <fieldset>
      <legend>Permission scope</legend>
      ...
    </fieldset>
    <footer>...</footer>
  </form>
</section>

import "@a3s-lab/ui/a3s.css";
import "@a3s-lab/ui/all";

#Usage

<section
  class="approval-request"
  data-state="pending"
  aria-labelledby="approval-title"
>
  <header>
    <div>
      <h2 id="approval-title">Allow this command?</h2>
      <p>Reason and impact.</p>
    </div>
  </header>
  <section>Exact resource, command, site, or capability.</section>
  <form>
    <fieldset>
      <legend>Permission scope</legend>
      ...
    </fieldset>
    <footer>...</footer>
  </form>
</section>

#Parameters

#States and variants

Render only scopes that policy actually permits. Finished states should replace decision controls with immutable outcome text, actor, and time. If approval expires while focused, retain the explanation, disable stale controls, and announce that a fresh request is required.

The component emits no policy events. Use native submit for the selected scope and ordinary button events for denial or cancellation. Applications may cancel Submit to perform an asynchronous decision.

#Accessibility

Use a heading referenced by aria-labelledby. Explain the concrete resource and consequence before the controls. Scope options use native radio inputs in a Fieldset. Move focus to the request heading only when the request blocks the current task; otherwise announce its arrival without stealing focus. Never use color as the only distinction between pending, approved, and denied states.