A live AI call the reader runs on a marketing page, shown as labeled fields marked as AI-written.
<form class="cap-ai-sample" data-cap="ai-sample" id="as-result">
<div class="cap-ai-sample-head">
<p class="cap-eyebrow" data-variant="mono">Live email writer</p>
<span class="cap-ai-sample-live">Calls real AI</span>
</div>
<div class="cap-ai-sample-controls">
<fieldset class="cap-seg">
<legend>Reminder type</legend>
<div class="cap-seg-options">
<label><input type="radio" name="kind" value="due" checked /> Due soon</label>
<label><input type="radio" name="kind" value="late" /> Overdue</label>
<label><input type="radio" name="kind" value="thanks" /> Thank you</label>
</div>
</fieldset>
<div class="cap-ai-sample-action">
<button type="submit" class="cap-btn" data-variant="primary" data-ai-sample-generate data-busy-label="Writing..."><span class="cap-btn-label">Write a sample email</span></button>
<p class="cap-ai-sample-hint">A live AI call for a fictional customer.</p>
</div>
</div>
<div class="cap-ai-sample-out" aria-live="polite"></div>
</form>
Copy
View code
Installation
HTML and CSS React
// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/ai-sample.css";
import { enhance } from "capsomer/behavior/ai-sample";
enhance();Copy
import "capsomer/tokens.css";
import "capsomer/ai-sample.css";
import { AiSample } from "capsomer/react/ai-sample";Copy
Usage
<form class="cap-ai-sample" data-cap="ai-sample">
<div class="cap-ai-sample-head">
<p class="cap-ai-sample-title">Live email writer</p>
<span class="cap-ai-sample-live">Calls real AI</span>
</div>
<div class="cap-ai-sample-controls">
<fieldset class="cap-seg">…</fieldset>
<div class="cap-ai-sample-action">
<button type="submit" class="cap-btn" data-variant="primary" data-ai-sample-generate data-busy-label="Writing...">
<span class="cap-btn-label">Write a sample email</span>
</button>
<p class="cap-ai-sample-hint">A live AI call for a fictional customer.</p>
</div>
</div>
<div class="cap-ai-sample-out" aria-live="polite"></div>
</form>Copy
Examples
Failed, without a live badge
<form class="cap-ai-sample" data-cap="ai-sample" id="as-failed">
<div class="cap-ai-sample-head"><p class="cap-eyebrow" data-variant="mono">Sample reply</p></div>
<div class="cap-ai-sample-controls">
<label class="cap-check"><input type="checkbox" name="formal" /><span>Formal</span></label>
<div class="cap-ai-sample-action"><button type="submit" class="cap-btn" data-variant="primary" data-ai-sample-generate><span class="cap-btn-label">Write a reply</span></button></div>
</div>
<div class="cap-ai-sample-out" aria-live="polite"><p class="cap-ai-sample-error">Generation failed. Try again.</p></div>
</form>
Copy
View code
API reference
AiSample Prop Type Required Does titleReactNodeYes liveReactNode"Calls real AI". Omit for no live badge. childrenReactNodeYes The inputs: a segmented control, radios, a select. Their names are the form's fields. buttonReactNodeYes busyLabelstringSaid to a screen reader while the call runs; the button keeps its words under a spinner. hintReactNodeThe line under the button: what the call is run on. busybooleanresultAiSampleResult | nullfailedReactNodeonGenerate(data: FormData) => voidYes onChange() => void
Functions Function Signature Does drawSample(out: HTMLElement, result: AiSampleResult | null, failed?: string): voidDraws a sample, the failure line, or nothing, into the live region. Exported for a page that runs its own request; enhance() uses it. enhance(root: ParentNode | undefined, options: AiSampleOptions): () => voidWires every [data-cap="ai-sample"]: a form holding the inputs, a [data-ai-sample-generate] button whose data-busy-label is said while the call runs, and a .cap-ai-sample-out live region.
Parts and data attributes Class Is .cap-ai-samplethe root .cap-ai-sample-actiona part .cap-ai-sample-controlsa part .cap-ai-sample-errora part .cap-ai-sample-fielda part .cap-ai-sample-heada part .cap-ai-sample-hinta part .cap-ai-sample-labela part .cap-ai-sample-livea part .cap-ai-sample-notea part .cap-ai-sample-outa part .cap-ai-sample-resulta part
Attribute Values data-variantmono
State Read from :emptythe platform
Accessibility
Key Does Arrow keys Choose an input (native radios) Enter, Space on the button Generate
The live badge is text ("Calls real AI"), its dot decoration. The failure line is --crit text with its words, not color alone.