Skip to content

AI sample

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>

Installation

// 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();

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>

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>

API reference

AiSample

PropTypeRequiredDoes
titleReactNodeYes
liveReactNode"Calls real AI". Omit for no live badge.
childrenReactNodeYesThe 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.
busyboolean
resultAiSampleResult | null
failedReactNode
onGenerate(data: FormData) => voidYes
onChange() => void

Functions

FunctionSignatureDoes
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

ClassIs
.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
AttributeValues
data-variantmono
StateRead from
:emptythe platform

Accessibility

KeyDoes
Arrow keysChoose an input (native radios)
Enter, Space on the buttonGenerate
  • The live badge is text ("Calls real AI"), its dot decoration.
  • The failure line is --crit text with its words, not color alone.