Skip to content
UI Kit
Accent color

Writing assistant

Writing help in a document. Inline suggestions by kind, rewriting in a chosen tone, tracked changes to accept or reject, a toolbar on selected words and a draft written point by point from an outline.

One of 3 components in AI writing and creation

5 variants

Variants

Inline suggestions

Underlines by kind in the text, a card with the change and its reason beside it. Accepting replaces the words and flashes them, the rest stays in a list.

Open in Studio

Rewrite in a tone

The original beside the rewrite, tones as a choice, the new text streams in at a stable height with its word count. Replace, insert below or try again.

Open in Studio

Review changes

Suggested edits as tracked changes in the text, each with accept and reject, the reason under the text and a counter in the header. Undo brings everything back.

Open in Studio

Selection toolbar

A toolbar floats above the selected words with improve, shorten, simplify and translate, the result opens below with replace. A free question works with your own model.

Open in Studio

Draft from an outline

Points to include on the left, the draft writes itself paragraph by paragraph when it scrolls into view. Pointing at a point lights up its paragraph.

Open in Studio

Details

What Writing assistant brings along, read from the registry and the source.

Area
App
Variants
5
Version
1.0.0 · since 1.1.0
File
components/ui/writing-assistant.tsx
Brings along
utilskiticonrevealmotion
npm packages
None
Languages
English and German, 42 texts of its own

Props

The WritingAssistantProps interface from components/ui/writing-assistant.tsx, with the comments from the code.

  • variantoptional
    WritingAssistantVariant

    inline-suggestionsrewrite-tonediff-reviewselection-toolbaroutline-draft

  • titleoptional
    string
  • docoptional
    string

    Name of the document

  • textoptional
    string

    The text, blank lines make paragraphs

  • issuesoptional
    WritingIssue[]

    inline-suggestions

  • tonesoptional
    WritingTone[]

    rewrite-tone

  • segmentsoptional
    WritingSegment[]

    diff-review

  • selectionoptional
    string

    selection-toolbar: the words that start selected

  • actionsoptional
    WritingAction[]
  • onActionoptional
    (action: string, selected: string) => string | Promise<string>

    selection-toolbar: produce a result for any selection, without it only the start selection has results

  • outlineoptional
    WritingPoint[]

    outline-draft

Built-in texts

Writing assistant writes these texts itself. The language follows the KitProvider, the labels prop replaces single ones.

Show all 42 texts
suggestionsEnglish SuggestionsGerman Vorschläge
grammarEnglish GrammarGerman Grammatik
clarityEnglish ClarityGerman Klarheit
toneEnglish ToneGerman Ton
styleEnglish StyleGerman Stil
acceptEnglish AcceptGerman Übernehmen
dismissEnglish DismissGerman Ignorieren
acceptAllEnglish Accept allGerman Alle übernehmen
doneEnglish All suggestions handled.German Alle Vorschläge erledigt.
leftEnglish {n} openGerman {n} offen
originalEnglish Your textGerman Dein Text
rewritingEnglish WritingGerman Schreibt
useTextEnglish Replace textGerman Text ersetzen
insertBelowEnglish Insert belowGerman Darunter einfügen
againEnglish Try againGerman Neu versuchen
wordsEnglish {n} wordsGerman {n} Wörter
appliedEnglish Text replaced.German Text ersetzt.
insertedEnglish Inserted below your text.German Unter deinem Text eingefügt.
undoEnglish UndoGerman Rückgängig
changeEnglish Change {n} of {total}German Änderung {n} von {total}
prevEnglish Previous changeGerman Vorherige Änderung
nextEnglish Next changeGerman Nächste Änderung
rejectEnglish RejectGerman Ablehnen
rejectAllEnglish Reject allGerman Alle ablehnen
reviewLeftEnglish {n} of {total} changes leftGerman {n} von {total} Änderungen offen
reviewDoneEnglish Review finishedGerman Durchsicht fertig
selectedEnglish Selected textGerman Markierter Text
askEnglish Ask about the selectionGerman Frage zur Auswahl
sendEnglish AskGerman Fragen
askPlaceholderEnglish Make it sound less formalGerman Weniger förmlich formulieren
replaceEnglish ReplaceGerman Ersetzen
closeEnglish CloseGerman Schließen
selectHintEnglish Select text to see the toolsGerman Markiere Text, dann erscheinen die Werkzeuge
noResultEnglish This demo has results for the marked words only.German Diese Demo hat Ergebnisse nur für die markierten Wörter.
outlineEnglish OutlineGerman Gliederung
draftEnglish DraftGerman Entwurf
writeEnglish Write the draftGerman Entwurf schreiben
writingEnglish Writing paragraph {n} of {total}German Schreibt Absatz {n} von {total}
rewriteDraftEnglish Write againGerman Neu schreiben
includeEnglish Include {name}German {name} einbeziehen
reviewEnglish Drafts are a start. Check facts, names and numbers before you send anything.German Entwürfe sind ein Anfang. Prüf Fakten, Namen und Zahlen, bevor du etwas verschickst.
issueEnglish {kind} suggestionGerman Vorschlag zu {kind}

Accessibility

Read from the source of the component.

  • Writing assistant handles the keys Enter, Arrow up, Arrow down, Arrow left, Arrow right and Space itself.
  • Sets aria-busy, aria-checked, aria-label, aria-live and aria-pressed, so screen readers announce purpose and state.
  • Uses the roles button, radio, radiogroup, status and toolbar.
  • Announces changes through a live region without moving focus.
  • Every field has a label, visible or for screen readers.
  • Adds text for screen readers where icons and graphics stand alone.
  • Shows a visible focus ring when used with the keyboard.
  • The server renders the starting state in full, JavaScript only adds the interaction.

Motion

  • Rises in briefly the first time it comes into view (kit-rise, useInView).
  • Brings animations of its own, calmly timed and without wobble.
  • With reduced motion (prefers-reduced-motion) it stays still.

Source

The file aiw add puts into your project. From then on it is yours.

Show the file, 968 lines
components/ui/writing-assistant.tsx
'use client';

import { Fragment, useEffect, useLayoutEffect, useRef, useState } from 'react';
import { cn, prefersReducedMotion, round, useInView, useTexts } from '@/lib/kit';
import { Icon, type IconName } from '@/components/ui/icon';
import { Reveal } from '@/components/ui/reveal';
import { Stagger } from '@/components/ui/motion';

export type WritingAssistantVariant = 'inline-suggestions' | 'rewrite-tone' | 'diff-review' | 'selection-toolbar' | 'outline-draft';

export interface WritingIssue {
  id: string;
  kind: 'grammar' | 'clarity' | 'tone' | 'style';
  /** The exact words in the text */
  find: string;
  replace: string;
  reason: string;
}

export interface WritingTone {
  id: string;
  label: string;
  icon?: IconName;
  /** The rewritten text for this tone */
  result: string;
}

export interface WritingSegment {
  /** Plain text between changes */
  text?: string;
  /** A change: id plus what goes and what comes */
  id?: string;
  del?: string;
  ins?: string;
  reason?: string;
}

export interface WritingAction {
  id: string;
  label: string;
  icon?: IconName;
  /** The result for the selected words */
  result: string;
}

export interface WritingPoint {
  id: string;
  point: string;
  /** The paragraph written for this point */
  draft: string;
}

export interface WritingAssistantProps {
  variant?: WritingAssistantVariant;
  title?: string;
  /** Name of the document */
  doc?: string;
  /** The text, blank lines make paragraphs */
  text?: string;
  /** inline-suggestions */
  issues?: WritingIssue[];
  /** rewrite-tone */
  tones?: WritingTone[];
  /** diff-review */
  segments?: WritingSegment[];
  /** selection-toolbar: the words that start selected */
  selection?: string;
  actions?: WritingAction[];
  /** selection-toolbar: produce a result for any selection, without it only the start selection has results */
  onAction?: (action: string, selected: string) => string | Promise<string>;
  /** outline-draft */
  outline?: WritingPoint[];
  labels?: Partial<(typeof TEXTS)['en']>;
  className?: string;
}

const TEXTS = {
  en: {
    suggestions: 'Suggestions',
    grammar: 'Grammar',
    clarity: 'Clarity',
    tone: 'Tone',
    style: 'Style',
    accept: 'Accept',
    dismiss: 'Dismiss',
    acceptAll: 'Accept all',
    done: 'All suggestions handled.',
    left: '{n} open',
    
    original: 'Your text',
    
    rewriting: 'Writing',
    useText: 'Replace text',
    insertBelow: 'Insert below',
    again: 'Try again',
    words: '{n} words',
    applied: 'Text replaced.',
    inserted: 'Inserted below your text.',
    undo: 'Undo',
    
    change: 'Change {n} of {total}',
    prev: 'Previous change',
    next: 'Next change',
    reject: 'Reject',
    rejectAll: 'Reject all',
    
    
    reviewLeft: '{n} of {total} changes left',
    reviewDone: 'Review finished',
    selected: 'Selected text',
    ask: 'Ask about the selection',
    send: 'Ask',
    askPlaceholder: 'Make it sound less formal',
    
    replace: 'Replace',
    close: 'Close',
    selectHint: 'Select text to see the tools',
    noResult: 'This demo has results for the marked words only.',
    outline: 'Outline',
    draft: 'Draft',
    write: 'Write the draft',
    writing: 'Writing paragraph {n} of {total}',
    rewriteDraft: 'Write again',
    include: 'Include {name}',
    review: 'Drafts are a start. Check facts, names and numbers before you send anything.',
    issue: '{kind} suggestion',
  },
  de: {
    suggestions: 'Vorschläge',
    grammar: 'Grammatik',
    clarity: 'Klarheit',
    tone: 'Ton',
    style: 'Stil',
    accept: 'Übernehmen',
    dismiss: 'Ignorieren',
    acceptAll: 'Alle übernehmen',
    done: 'Alle Vorschläge erledigt.',
    left: '{n} offen',
    
    original: 'Dein Text',
    
    rewriting: 'Schreibt',
    useText: 'Text ersetzen',
    insertBelow: 'Darunter einfügen',
    again: 'Neu versuchen',
    words: '{n} Wörter',
    applied: 'Text ersetzt.',
    inserted: 'Unter deinem Text eingefügt.',
    undo: 'Rückgängig',
    
    change: 'Änderung {n} von {total}',
    prev: 'Vorherige Änderung',
    next: 'Nächste Änderung',
    reject: 'Ablehnen',
    rejectAll: 'Alle ablehnen',
    
    
    reviewLeft: '{n} von {total} Änderungen offen',
    reviewDone: 'Durchsicht fertig',
    selected: 'Markierter Text',
    ask: 'Frage zur Auswahl',
    send: 'Fragen',
    askPlaceholder: 'Weniger förmlich formulieren',
    
    replace: 'Ersetzen',
    close: 'Schließen',
    selectHint: 'Markiere Text, dann erscheinen die Werkzeuge',
    noResult: 'Diese Demo hat Ergebnisse nur für die markierten Wörter.',
    outline: 'Gliederung',
    draft: 'Entwurf',
    write: 'Entwurf schreiben',
    writing: 'Schreibt Absatz {n} von {total}',
    rewriteDraft: 'Neu schreiben',
    include: '{name} einbeziehen',
    review: 'Entwürfe sind ein Anfang. Prüf Fakten, Namen und Zahlen, bevor du etwas verschickst.',
    issue: 'Vorschlag zu {kind}',
  },
};

type Texts = (typeof TEXTS)['en'];
type P = WritingAssistantProps & { t: Texts };
const fill = (s: string, v: Record<string, string | number>) => s.replace(/\{(\w+)\}/g, (_, k) => String(v[k] ?? ''));
const useIso = typeof window === 'undefined' ? useEffect : useLayoutEffect;
const words = (s: string) => (s.trim() ? s.trim().split(/\s+/).length : 0);

/** State seeded from a prop that starts over when the prop changes (the Studio edits props live) */
function useSynced<T>(value: T) {
  const [state, setState] = useState(value);
  const key = JSON.stringify(value);
  const seen = useRef(key);
  if (seen.current !== key) {
    seen.current = key;
    setState(value);
  }
  return [state, setState] as const;
}

const CSS =
  '@keyframes wra-up{from{opacity:0;transform:translateY(8px)}}@keyframes wra-pop{from{opacity:0;transform:translateY(4px) scale(.97)}}@keyframes wra-flash{from{background-color:color-mix(in oklab,var(--success) 30%,transparent)}}@keyframes wra-out{to{opacity:0;transform:translateX(16px)}}' +
  '@media (prefers-reduced-motion:no-preference){.wra-up{animation:wra-up .45s var(--ease-kit) var(--wra-d,0ms) both}.wra-pop{animation:wra-pop .24s var(--ease-kit) both}.wra-flash{animation:wra-flash 1.6s ease-out both}.wra-out{animation:wra-out .3s var(--ease-kit) both}}';

function Style() {
  return (
    <style href="kit-writing-assistant" precedence="default">
      {CSS}
    </style>
  );
}

/** Text that types itself once it is set, the full text on the server and with reduced motion */
function useStream(full: string, run: boolean, speed = 3, nonce = 0) {
  const [n, setN] = useState(full.length);
  useEffect(() => {
    if (!run || prefersReducedMotion()) return setN(full.length);
    setN(0);
    const id = window.setInterval(() => setN((v) => (v >= full.length ? (window.clearInterval(id), v) : v + speed)), 16);
    return () => window.clearInterval(id);
  }, [full, run, speed, nonce]);
  return [full.slice(0, n), n < full.length] as const;
}

/* ------------------------------------------------------------------ */
/* Shared parts                                                        */
/* ------------------------------------------------------------------ */

const KIND: Record<WritingIssue['kind'], { line: string; dot: string; soft: string }> = {
  grammar: { line: 'decoration-[color-mix(in_oklab,var(--destructive)_80%,transparent)]', dot: 'bg-destructive', soft: 'bg-[color-mix(in_oklab,var(--destructive)_12%,transparent)]' },
  clarity: { line: 'decoration-[color-mix(in_oklab,var(--primary)_85%,transparent)]', dot: 'bg-primary', soft: 'bg-[color-mix(in_oklab,var(--primary)_12%,transparent)]' },
  tone: { line: 'decoration-[color-mix(in_oklab,var(--warning)_90%,transparent)]', dot: 'bg-warning', soft: 'bg-[color-mix(in_oklab,var(--warning)_16%,transparent)]' },
  style: { line: 'decoration-[color-mix(in_oklab,var(--success)_85%,transparent)]', dot: 'bg-success', soft: 'bg-[color-mix(in_oklab,var(--success)_14%,transparent)]' },
};

function Stage({ title, children, className, wide }: { title?: string; children: React.ReactNode; className?: string; wide?: boolean }) {
  return (
    <section className={cn('kit-glow relative overflow-clip bg-surface py-12 sm:py-16 lg:py-20', className)}>
      <div className="kit-container">
        <div className={cn('mx-auto w-full', wide ? 'max-w-[68rem]' : 'max-w-[48rem]')}>
          {title && (
            <Reveal className="mb-6 sm:mb-8">
              <h2 className="text-balance text-[22px] font-semibold leading-tight tracking-[-0.02em] text-foreground sm:text-[26px]">{title}</h2>
            </Reveal>
          )}
          {children}
        </div>
      </div>
    </section>
  );
}

/** The sheet the text sits on, with the document name in a quiet header */
function Paper({ doc, children, className, aside }: { doc?: string; children: React.ReactNode; className?: string; aside?: React.ReactNode }) {
  return (
    <div className={cn('relative rounded-2xl border border-border bg-card shadow-[var(--highlight),var(--shadow-md)]', className)}>
      {doc && (
        <div className="flex h-12 items-center gap-2 border-b border-border px-4 text-[13px] text-muted-foreground sm:px-6">
          <Icon name="file" size={15} />
          <span className="min-w-0 flex-1 truncate">{doc}</span>
          {aside}
        </div>
      )}
      <div className="px-5 py-6 sm:px-8 sm:py-8">{children}</div>
    </div>
  );
}

const prose = 'space-y-4 text-pretty text-[16px] leading-[1.8] text-foreground';
const btn = 'inline-flex h-11 items-center justify-center gap-1.5 rounded-lg px-3.5 text-[13px] font-medium transition-colors sm:h-9';
const primaryBtn = cn(btn, 'bg-primary text-primary-foreground shadow-[inset_0_1px_0_rgb(255_255_255/0.18),var(--shadow-sm)] hover:bg-[color-mix(in_oklab,var(--primary)_88%,var(--background))]');
const quietBtn = cn(btn, 'border border-border bg-card text-foreground hover:bg-accent');

/* ------------------------------------------------------------------ */
/* inline-suggestions                                                  */
/* ------------------------------------------------------------------ */

function InlineSuggestions({ t, title, doc, text = '', issues = [], className }: P) {
  const [body, setBody] = useSynced(text);
  const [open, setOpen] = useState<string[]>(issues.map((i) => i.id));
  const [active, setActive] = useState<string | null>(issues[0]?.id ?? null);
  const [fresh, setFresh] = useState<string | null>(null);
  const list = issues.filter((i) => open.includes(i.id) && body.includes(i.find));
  const cur = list.find((i) => i.id === active) ?? list[0] ?? null;

  const accept = (i: WritingIssue) => {
    setBody((b) => b.replace(i.find, i.replace));
    setOpen((o) => o.filter((x) => x !== i.id));
    setFresh(i.replace);
    setActive(list.find((x) => x.id !== i.id)?.id ?? null);
  };
  const dismiss = (i: WritingIssue) => {
    setOpen((o) => o.filter((x) => x !== i.id));
    setActive(list.find((x) => x.id !== i.id)?.id ?? null);
  };

  // Mark every open issue and the last accepted replacement inside the paragraphs
  const render = (para: string) => {
    const marks = [...list.map((i) => ({ at: para.indexOf(i.find), len: i.find.length, issue: i as WritingIssue | null })), ...(fresh && para.includes(fresh) ? [{ at: para.indexOf(fresh), len: fresh.length, issue: null }] : [])].filter((m) => m.at >= 0).sort((a, b) => a.at - b.at);
    const out: React.ReactNode[] = [];
    let pos = 0;
    marks.forEach((m, k) => {
      if (m.at < pos) return;
      out.push(<Fragment key={`t${k}`}>{para.slice(pos, m.at)}</Fragment>);
      const seg = para.slice(m.at, m.at + m.len);
      if (m.issue) {
        const i = m.issue;
        const on = i.id === active;
        out.push(
          // A span stays in the flow of the text, a button would wrap as a block
          <span
            key={i.id}
            role="button"
            tabIndex={0}
            aria-pressed={on}
            aria-label={`${seg}. ${fill(t.issue, { kind: t[i.kind] })}`}
            onClick={() => setActive(i.id)}
            onKeyDown={(e) => {
              if (e.key !== 'Enter' && e.key !== ' ') return;
              e.preventDefault();
              setActive(i.id);
            }}
            className={cn('cursor-pointer rounded-[3px] underline decoration-2 underline-offset-[5px] transition-colors duration-200 [box-decoration-break:clone]', KIND[i.kind].line, on && KIND[i.kind].soft)}
          >
            {seg}
          </span>,
        );
      } else {
        out.push(
          <span key={`f${k}`} className="wra-flash rounded-[3px]">
            {seg}
          </span>,
        );
      }
      pos = m.at + m.len;
    });
    out.push(<Fragment key="end">{para.slice(pos)}</Fragment>);
    return out;
  };

  const counts = (['grammar', 'clarity', 'tone', 'style'] as const).map((k) => ({ k, n: list.filter((i) => i.kind === k).length }));

  return (
    <Stage title={title} className={className} wide>
      <div className="grid grid-cols-1 gap-4 lg:grid-cols-[minmax(0,1fr)_20rem] lg:items-start lg:gap-6">
        <Reveal delay={60}>
          <Paper doc={doc}>
            <div className={prose}>
              {body.split(/\n{2,}/).map((para, i) => (
                <p key={i}>{render(para)}</p>
              ))}
            </div>
          </Paper>
        </Reveal>
        <Reveal delay={160} className="lg:sticky lg:top-6">
          <aside aria-label={t.suggestions} className="rounded-2xl border border-border bg-card shadow-[var(--highlight),var(--shadow-sm)]">
            <div className="flex items-center justify-between gap-3 border-b border-border px-4 py-3">
              <p className="text-[13px] font-medium text-foreground">{t.suggestions}</p>
              <span className="text-[12px] tabular-nums text-muted-foreground" aria-live="polite">
                {fill(t.left, { n: list.length })}
              </span>
            </div>
            <div className="flex flex-wrap gap-x-4 gap-y-1.5 px-4 pt-3 text-[12px] text-muted-foreground">
              {counts.map(({ k, n }) => (
                <span key={k} className={cn('inline-flex items-center gap-1.5 transition-opacity', !n && 'opacity-50')}>
                  <span className={cn('size-2 rounded-full', KIND[k].dot)} />
                  {t[k]} <span className="tabular-nums text-foreground">{n}</span>
                </span>
              ))}
            </div>
            <div className="p-3">
              {cur ? (
                <div key={cur.id} className="wra-pop rounded-xl border border-border bg-background/60 p-3.5">
                  <p className="flex items-center gap-1.5 text-[12px] font-medium text-muted-foreground">
                    <span className={cn('size-2 rounded-full', KIND[cur.kind].dot)} />
                    {t[cur.kind]}
                  </p>
                  <p className="mt-2 text-[14px] leading-relaxed">
                    <del className="text-muted-foreground decoration-[color-mix(in_oklab,var(--destructive)_60%,transparent)]">{cur.find}</del>
                    <Icon name="arrow-right" size={13} className="mx-1.5 inline text-subtle-foreground" />
                    <ins className="font-medium text-foreground no-underline">{cur.replace}</ins>
                  </p>
                  <p className="mt-2 text-pretty text-[12.5px] leading-relaxed text-muted-foreground">{cur.reason}</p>
                  <div className="mt-3 flex gap-2">
                    <button type="button" onClick={() => accept(cur)} className={cn(primaryBtn, 'flex-1')}>
                      <Icon name="check" size={15} />
                      {t.accept}
                    </button>
                    <button type="button" onClick={() => dismiss(cur)} className={cn(quietBtn, 'flex-1')}>
                      {t.dismiss}
                    </button>
                  </div>
                </div>
              ) : (
                <p className="wra-pop flex items-center gap-2 rounded-xl bg-[color-mix(in_oklab,var(--success)_10%,transparent)] px-3.5 py-3 text-[13px] text-success-foreground">
                  <Icon name="check-circle" size={16} />
                  {t.done}
                </p>
              )}
              {list.length > 1 && (
                <ul className="mt-2 space-y-0.5">
                  {list
                    .filter((i) => i.id !== cur?.id)
                    .map((i) => (
                      <li key={i.id}>
                        <button type="button" onClick={() => setActive(i.id)} className="flex min-h-11 w-full items-center gap-2.5 rounded-lg px-2 text-left text-[13px] hover:bg-accent sm:min-h-9">
                          <span className={cn('size-2 shrink-0 rounded-full', KIND[i.kind].dot)} />
                          <span className="min-w-0 flex-1 truncate text-muted-foreground">{`${i.find} → ${i.replace}`}</span>
                        </button>
                      </li>
                    ))}
                </ul>
              )}
              {list.length > 1 && (
                <button type="button" onClick={() => (setBody((b) => list.reduce((acc, i) => acc.replace(i.find, i.replace), b)), setOpen([]), setFresh(null))} className={cn(quietBtn, 'mt-2 w-full')}>
                  {t.acceptAll}
                </button>
              )}
            </div>
          </aside>
        </Reveal>
      </div>
    </Stage>
  );
}

/* ------------------------------------------------------------------ */
/* rewrite-tone                                                        */
/* ------------------------------------------------------------------ */

function RewriteTone({ t, title, doc, text = '', tones = [], className }: P) {
  const [tone, setTone] = useState(tones[0]?.id);
  const [round_, setRound] = useState(0);
  const [applied, setApplied] = useState<'replace' | 'below' | null>(null);
  const [ref, inView] = useInView<HTMLDivElement>();
  // Streams once when it first comes into view, not again on every return
  const [seen, setSeen] = useState(false);
  useEffect(() => {
    if (inView) setSeen(true);
  }, [inView]);
  const cur = tones.find((x) => x.id === tone) ?? tones[0];
  const [shown, busy] = useStream(cur?.result ?? '', seen, 3, round_);
  const before = words(text);
  const after = words(cur?.result ?? '');
  const tabs = useRef<(HTMLButtonElement | null)[]>([]);

  return (
    <Stage title={title} className={className} wide>
      <div ref={ref} className="grid grid-cols-1 gap-4 lg:grid-cols-2 lg:gap-6">
        <Reveal delay={60}>
          <Paper doc={doc} aside={<span className="tabular-nums">{fill(t.words, { n: before })}</span>}>
            <p className="mb-2 text-[12px] font-medium text-subtle-foreground">{t.original}</p>
            <div className={cn(prose, applied === 'replace' && 'text-muted-foreground line-through decoration-[color-mix(in_oklab,var(--foreground)_30%,transparent)]')}>
              {text.split(/\n{2,}/).map((p, i) => (
                <p key={i}>{p}</p>
              ))}
            </div>
            {applied && (
              <div className="wra-up mt-4 rounded-xl border border-[color-mix(in_oklab,var(--success)_40%,var(--border))] bg-[color-mix(in_oklab,var(--success)_7%,var(--card))] p-4 text-[15px] leading-[1.75] text-foreground">
                {cur?.result}
              </div>
            )}
          </Paper>
        </Reveal>
        <Reveal delay={160}>
          <div className="rounded-2xl border border-border bg-card shadow-[var(--highlight),var(--shadow-md)]">
            <div className="border-b border-border p-3">
              <div role="radiogroup" aria-label={t.tone} className="grid grid-cols-2 gap-1.5 sm:grid-cols-4">
                {tones.map((x, i) => {
                  const on = x.id === cur?.id;
                  return (
                    <button
                      key={x.id}
                      ref={(el) => {
                        tabs.current[i] = el;
                      }}
                      type="button"
                      role="radio"
                      aria-checked={on}
                      tabIndex={on ? 0 : -1}
                      onClick={() => (setTone(x.id), setApplied(null))}
                      onKeyDown={(e) => {
                        const d = ['ArrowRight', 'ArrowDown'].includes(e.key) ? 1 : ['ArrowLeft', 'ArrowUp'].includes(e.key) ? -1 : 0;
                        if (!d) return;
                        e.preventDefault();
                        const n = (i + d + tones.length) % tones.length;
                        setTone(tones[n].id);
                        setApplied(null);
                        tabs.current[n]?.focus();
                      }}
                      className={cn('inline-flex min-h-11 items-center justify-center gap-1.5 rounded-lg border px-2 text-[13px] font-medium transition-colors duration-200 sm:min-h-10', on ? 'border-[color-mix(in_oklab,var(--primary)_50%,var(--border))] bg-[color-mix(in_oklab,var(--primary)_12%,var(--card))] text-foreground' : 'border-border text-muted-foreground hover:text-foreground')}
                    >
                      <Icon name={x.icon ?? 'sparkle'} size={15} className={on ? 'text-primary' : undefined} />
                      {x.label}
                    </button>
                  );
                })}
              </div>
            </div>
            <div className="p-5 sm:p-6" aria-live="polite" aria-busy={busy}>
              <p className="mb-2 flex items-center justify-between text-[12px] font-medium text-subtle-foreground">
                <span className="flex items-center gap-1.5">
                  <Icon name="sparkle" size={13} className="text-primary" />
                  {busy ? t.rewriting : cur?.label}
                </span>
                <span className="tabular-nums">
                  {fill(t.words, { n: after })}
                  <span className={cn('ml-1.5', after < before ? 'text-success-foreground' : 'text-muted-foreground')}>
                    {after < before ? '−' : '+'}
                    {Math.abs(after - before)}
                  </span>
                </span>
              </p>
              {/* The full text holds the height, the streamed text lies on top */}
              <div className="relative text-[16px] leading-[1.8]">
                <p aria-hidden className="invisible">
                  {cur?.result}
                </p>
                <p className="absolute inset-0 text-foreground">
                  {shown}
                  {busy && <span aria-hidden className="ml-0.5 inline-block h-[1.05em] w-0.5 translate-y-[0.18em] animate-kit-pulse bg-primary" />}
                </p>
              </div>
            </div>
            <div className="flex flex-wrap gap-2 border-t border-border bg-surface/60 p-3">
              <button type="button" disabled={busy} onClick={() => setApplied('replace')} className={cn(primaryBtn, 'disabled:opacity-50')}>
                <Icon name="check" size={15} />
                {t.useText}
              </button>
              <button type="button" disabled={busy} onClick={() => setApplied('below')} className={cn(quietBtn, 'disabled:opacity-50')}>
                {t.insertBelow}
              </button>
              <button type="button" disabled={busy} onClick={() => (setRound((r) => r + 1), setApplied(null))} className={cn(btn, 'ml-auto min-w-11 text-muted-foreground hover:bg-accent hover:text-foreground disabled:opacity-50')}>
                <Icon name="refresh" size={15} />
                <span className="max-sm:sr-only">{t.again}</span>
              </button>
            </div>
          </div>
          {applied && (
            <p role="status" className="wra-up mt-3 flex items-center justify-between gap-3 rounded-xl border border-border bg-card px-4 py-2 text-[13px] text-muted-foreground">
              {applied === 'below' ? t.inserted : t.applied}
              <button type="button" onClick={() => setApplied(null)} className={cn(btn, '-my-1 px-2 text-foreground hover:bg-accent')}>
                {t.undo}
              </button>
            </p>
          )}
        </Reveal>
      </div>
    </Stage>
  );
}

/* ------------------------------------------------------------------ */
/* diff-review                                                         */
/* ------------------------------------------------------------------ */

function DiffReview({ t, title, doc, segments = [], className }: P) {
  const changes = segments.filter((s) => s.id);
  const [state, setState] = useState<Record<string, 'accepted' | 'rejected'>>({});
  const [focus, setFocus] = useState<string | null>(changes[0]?.id ?? null);
  const left = changes.filter((c) => !state[c.id!]).length;
  const decide = (id: string, v: 'accepted' | 'rejected') => {
    setState((s) => ({ ...s, [id]: v }));
    setFocus(changes.find((c) => c.id !== id && !state[c.id!])?.id ?? null);
  };
  const all = (v: 'accepted' | 'rejected') => setState(Object.fromEntries(changes.map((c) => [c.id!, state[c.id!] ?? v])));
  const share = changes.length ? (changes.length - left) / changes.length : 0;

  return (
    <Stage title={title} className={className}>
      <Reveal delay={60}>
        <Paper
          doc={doc}
          aside={
            <span className="flex items-center gap-2 tabular-nums" aria-live="polite">
              <span className="hidden h-1 w-16 overflow-hidden rounded-full bg-[color-mix(in_oklab,var(--foreground)_10%,transparent)] sm:block">
                <span className="block h-full origin-left rounded-full bg-primary transition-transform duration-500" style={{ transform: `scaleX(${round(share, 3)})` }} />
              </span>
              {left ? fill(t.reviewLeft, { n: left, total: changes.length }) : t.reviewDone}
            </span>
          }
        >
          <p className={cn(prose, 'leading-[2]')}>
            {segments.map((s, i) => {
              if (!s.id) return <Fragment key={i}>{s.text}</Fragment>;
              const st = state[s.id];
              if (st === 'accepted') return <span key={s.id} className="wra-flash rounded-[3px]">{s.ins}</span>;
              if (st === 'rejected') return <Fragment key={s.id}>{s.del}</Fragment>;
              const on = focus === s.id;
              return (
                <span
                  key={s.id}
                  role="button"
                  tabIndex={0}
                  aria-pressed={on}
                  onClick={() => setFocus(s.id!)}
                  onKeyDown={(e) => {
                    if (e.key !== 'Enter' && e.key !== ' ') return;
                    e.preventDefault();
                    setFocus(s.id!);
                  }}
                  className={cn('cursor-pointer rounded-md px-0.5 py-0.5 transition-[background-color,box-shadow] duration-200 [box-decoration-break:clone]', on && 'bg-accent shadow-[0_0_0_1px_var(--border-strong)]')}
                >
                  {s.del && <del className="rounded-[3px] bg-[color-mix(in_oklab,var(--destructive)_12%,transparent)] text-muted-foreground decoration-[color-mix(in_oklab,var(--destructive)_70%,transparent)] [box-decoration-break:clone]">{s.del}</del>}
                  {s.del && s.ins && ' '}
                  {s.ins && <ins className="rounded-[3px] bg-[color-mix(in_oklab,var(--success)_16%,transparent)] text-foreground no-underline [box-decoration-break:clone]">{s.ins}</ins>}
                </span>
              );
            })}
          </p>
        </Paper>
      </Reveal>
      {(() => {
        const open = changes.filter((x) => !state[x.id!]);
        const c = open.find((x) => x.id === focus) ?? open[0];
        if (!c) return null;
        const i = open.indexOf(c);
        const move = (dir: number) => setFocus(open[(i + dir + open.length) % open.length].id!);
        return (
          <div key={c.id} className="wra-up mt-3 rounded-2xl border border-border bg-card p-4 shadow-[var(--highlight),var(--shadow-sm)]" aria-live="polite">
            <div className="flex items-center justify-between gap-3">
              <p className="text-[12px] font-medium tabular-nums text-subtle-foreground">{fill(t.change, { n: i + 1, total: open.length })}</p>
              <span className="flex">
                <button type="button" aria-label={t.prev} disabled={open.length < 2} onClick={() => move(-1)} className="grid size-11 place-items-center rounded-lg text-muted-foreground hover:bg-accent hover:text-foreground disabled:opacity-30 sm:size-8">
                  <Icon name="chevron-left" size={16} />
                </button>
                <button type="button" aria-label={t.next} disabled={open.length < 2} onClick={() => move(1)} className="grid size-11 place-items-center rounded-lg text-muted-foreground hover:bg-accent hover:text-foreground disabled:opacity-30 sm:size-8">
                  <Icon name="chevron-right" size={16} />
                </button>
              </span>
            </div>
            {c.reason && (
              <p className="mt-1 flex items-start gap-2 text-pretty text-[13.5px] leading-relaxed text-muted-foreground">
                <Icon name="sparkle" size={14} className="mt-1 shrink-0 text-primary" />
                {c.reason}
              </p>
            )}
            <div className="mt-3 flex gap-2">
              <button type="button" onClick={() => decide(c.id!, 'accepted')} className={cn(primaryBtn, 'flex-1 sm:flex-none')}>
                <Icon name="check" size={15} />
                {t.accept}
              </button>
              <button type="button" onClick={() => decide(c.id!, 'rejected')} className={cn(quietBtn, 'flex-1 sm:flex-none')}>
                {t.reject}
              </button>
            </div>
          </div>
        );
      })()}
      <div className="mt-3 flex flex-wrap items-center gap-2">
        <button type="button" disabled={!left} onClick={() => all('accepted')} className={cn(quietBtn, 'disabled:opacity-50')}>
          {t.acceptAll}
        </button>
        <button type="button" disabled={!left} onClick={() => all('rejected')} className={cn(quietBtn, 'disabled:opacity-50')}>
          {t.rejectAll}
        </button>
        {Object.keys(state).length > 0 && (
          <button type="button" onClick={() => setState({})} className={cn(btn, 'ml-auto text-muted-foreground hover:bg-accent hover:text-foreground')}>
            <Icon name="undo" size={15} />
            {t.undo}
          </button>
        )}
      </div>
    </Stage>
  );
}

/* ------------------------------------------------------------------ */
/* selection-toolbar                                                   */
/* ------------------------------------------------------------------ */

function SelectionToolbar({ t, title, doc, text = '', selection = '', actions = [], onAction, className }: P) {
  const [body, setBody] = useSynced(text);
  const [sel, setSel] = useState(selection);
  const [result, setResult] = useState<{ action: WritingAction; text: string } | null>(null);
  const [ask, setAsk] = useState('');
  const [pos, setPos] = useState<{ left: number; top: number } | null>(null);
  // A toolbar wider than the paper scrolls, the cut edge fades instead of ending hard
  const [fade, setFade] = useState<'' | 'kit-fade-end' | 'kit-fade-x' | 'kit-fade-start'>('');
  const edge = (el: HTMLElement | null) => {
    if (!el) return;
    const max = el.scrollWidth - el.clientWidth;
    setFade(max <= 1 ? '' : el.scrollLeft <= 1 ? 'kit-fade-end' : el.scrollLeft >= max - 1 ? 'kit-fade-start' : 'kit-fade-x');
  };
  const [done, setDone] = useState<string | null>(null);
  const box = useRef<HTMLDivElement>(null);
  const mark = useRef<HTMLElement>(null);
  const bar = useRef<HTMLDivElement>(null);

  const measure = () => {
    const b = box.current?.getBoundingClientRect();
    const m = mark.current?.getBoundingClientRect();
    const w = bar.current?.offsetWidth ?? 0;
    if (!b || !m) return setPos(null);
    const left = Math.max(8, Math.min(b.width - w - 8, m.left - b.left + m.width / 2 - w / 2));
    setPos({ left: Math.round(left), top: Math.round(m.top - b.top - 8) });
    edge(bar.current);
  };
  useIso(() => {
    measure();
    window.addEventListener('resize', measure);
    return () => window.removeEventListener('resize', measure);
  }, [sel, body]);

  const run = async (a: WritingAction) => {
    const out = sel === selection ? a.result : onAction ? await onAction(a.id, sel) : '';
    setResult({ action: a, text: out });
  };
  const apply = () => {
    if (!result?.text) return;
    setBody((b) => b.replace(sel, result.text));
    setDone(result.text);
    setSel('');
    setResult(null);
  };
  const pick = () => {
    const s = window.getSelection();
    const str = s?.toString().trim() ?? '';
    if (!str || !box.current?.contains(s!.anchorNode) || !body.includes(str) || str === sel) return;
    setSel(str);
    setResult(null);
    s?.removeAllRanges();
  };

  const paras = body.split(/\n{2,}/);
  return (
    <Stage title={title} className={className}>
      <Reveal delay={60}>
        <Paper doc={doc}>
          <div ref={box} className="relative" onMouseUp={pick} onKeyUp={(e) => e.shiftKey && pick()}>
            {sel && (
              <div
                ref={bar}
                role="toolbar"
                aria-label={t.selected}
                onScroll={(e) => edge(e.currentTarget)}
                className={cn(fade, "wra-pop kit-no-scrollbar absolute z-20 flex max-w-[calc(100%-16px)] -translate-y-full items-center gap-0.5 overflow-x-auto rounded-xl border border-border bg-card p-1 shadow-[var(--highlight),var(--shadow-lg)]")}
                style={pos ? { left: pos.left, top: pos.top } : { left: 8, top: -8, visibility: 'hidden' }}
              >
                {actions.map((a) => (
                  <button key={a.id} type="button" aria-pressed={result?.action.id === a.id} onClick={() => run(a)} className={cn('inline-flex h-11 items-center gap-1.5 rounded-lg px-2.5 text-[13px] font-medium transition-colors sm:h-8', result?.action.id === a.id ? 'bg-[color-mix(in_oklab,var(--primary)_14%,var(--card))] text-foreground' : 'text-muted-foreground hover:bg-accent hover:text-foreground')}>
                    <Icon name={a.icon ?? 'sparkle'} size={15} className="max-sm:hidden" />
                    {a.label}
                  </button>
                ))}
              </div>
            )}
            <div className={cn(prose, 'pt-10')}>
              {paras.map((p, i) => {
                const at = sel ? p.indexOf(sel) : -1;
                const fresh = done && p.includes(done) ? p.indexOf(done) : -1;
                if (at >= 0)
                  return (
                    <p key={i}>
                      {p.slice(0, at)}
                      <mark ref={mark as React.RefObject<HTMLElement>} className="rounded-[3px] bg-[color-mix(in_oklab,var(--primary)_24%,transparent)] text-foreground [box-decoration-break:clone]">
                        {sel}
                      </mark>
                      {p.slice(at + sel.length)}
                    </p>
                  );
                if (fresh >= 0)
                  return (
                    <p key={i}>
                      {p.slice(0, fresh)}
                      <span className="wra-flash rounded-[3px]">{done}</span>
                      {p.slice(fresh + (done?.length ?? 0))}
                    </p>
                  );
                return <p key={i}>{p}</p>;
              })}
            </div>
          </div>
        </Paper>
      </Reveal>
      <div className="mt-3" aria-live="polite">
        {result ? (
          <div key={result.action.id} className="wra-up rounded-2xl border border-border bg-card p-4 shadow-[var(--highlight),var(--shadow-sm)] sm:p-5">
            <p className="flex items-center gap-1.5 text-[12px] font-medium text-subtle-foreground">
              <Icon name={result.action.icon ?? 'sparkle'} size={13} className="text-primary" />
              {result.action.label}
            </p>
            <p className="mt-2 text-[15px] leading-relaxed text-foreground">{result.text || t.noResult}</p>
            <div className="mt-3 flex flex-wrap gap-2">
              {result.text && (
                <button type="button" onClick={apply} className={primaryBtn}>
                  <Icon name="check" size={15} />
                  {t.replace}
                </button>
              )}
              <button type="button" onClick={() => setResult(null)} className={quietBtn}>
                {t.close}
              </button>
            </div>
          </div>
        ) : sel ? (
          <form
            className="flex gap-2"
            onSubmit={async (e) => {
              e.preventDefault();
              if (!ask.trim()) return;
              const out = onAction ? await onAction(ask, sel) : '';
              setResult({ action: { id: 'ask', label: ask, result: out }, text: out });
              setAsk('');
            }}
          >
            <label className="flex h-11 min-w-0 flex-1 items-center gap-2 rounded-xl border border-border bg-card px-3 shadow-[var(--shadow-sm)] focus-within:border-[color-mix(in_oklab,var(--primary)_50%,var(--border))] focus-within:shadow-[var(--shadow-sm),0_0_0_3px_color-mix(in_oklab,var(--primary)_16%,transparent)]">
              <Icon name="sparkle" size={15} className="shrink-0 text-primary" />
              <span className="sr-only">{t.ask}</span>
              <input value={ask} onChange={(e) => setAsk(e.target.value)} placeholder={t.askPlaceholder} className="w-0 min-w-0 flex-1 bg-transparent text-[14px] text-foreground outline-none placeholder:text-subtle-foreground focus-visible:outline-none" />
            </label>
            <button type="submit" disabled={!ask.trim()} className={cn(quietBtn, 'h-11 disabled:opacity-50 sm:h-11')}>
              {t.send}
            </button>
          </form>
        ) : (
          <p className="flex items-center gap-2 px-1 text-[13px] text-muted-foreground">
            <Icon name="info" size={14} />
            {t.selectHint}
          </p>
        )}
      </div>
    </Stage>
  );
}

/* ------------------------------------------------------------------ */
/* outline-draft                                                       */
/* ------------------------------------------------------------------ */

function OutlineDraft({ t, title, doc, outline = [], className }: P) {
  const [view, inView] = useInView<HTMLDivElement>('0px 0px -20% 0px');
  const started = useRef(false);
  const [on, setOn] = useState<string[]>(outline.map((o) => o.id));
  const [step, setStep] = useState(outline.length); // paragraphs written so far
  const [hover, setHover] = useState<string | null>(null);
  const picked = outline.filter((o) => on.includes(o.id));
  const writing = step < picked.length;
  const [shown] = useStream(picked[step]?.draft ?? '', writing, 4);
  useEffect(() => {
    if (!writing || shown.length < (picked[step]?.draft.length ?? 0)) return;
    const id = window.setTimeout(() => setStep((s) => s + 1), 250);
    return () => window.clearTimeout(id);
  }, [writing, shown, step, picked]);
  const start = () => setStep(prefersReducedMotion() ? picked.length : 0);
  useEffect(() => {
    if (!inView || started.current || prefersReducedMotion()) return;
    // The lock is set when the timer fires: strict mode clears the first timer and
    // starts a second one, and scrolling away and back never starts the draft again
    const id = window.setTimeout(() => {
      started.current = true;
      setStep(0);
    }, 500);
    return () => window.clearTimeout(id);
  }, [inView]);

  return (
    <Stage title={title} className={className} wide>
      <div ref={view} className="grid grid-cols-1 gap-4 lg:grid-cols-[19rem_minmax(0,1fr)] lg:items-start lg:gap-6">
        <Reveal delay={60} className="lg:sticky lg:top-6">
          <div className="rounded-2xl border border-border bg-card shadow-[var(--highlight),var(--shadow-sm)]">
            <p className="border-b border-border px-4 py-3 text-[13px] font-medium text-foreground">{t.outline}</p>
            <Stagger as="ol" step={60} className="p-2">
              {outline.map((o, i) => {
                const inc = on.includes(o.id);
                return (
                  <li key={o.id} onPointerEnter={() => setHover(o.id)} onPointerLeave={() => setHover(null)}>
                    <label className={cn('flex min-h-11 cursor-pointer items-start gap-3 rounded-lg px-2 py-2 transition-colors', hover === o.id && inc ? 'bg-accent' : 'hover:bg-accent/60')}>
                      <input
                        type="checkbox"
                        checked={inc}
                        disabled={writing}
                        onChange={() => setOn((s) => (s.includes(o.id) ? s.filter((x) => x !== o.id) : outline.filter((x) => s.includes(x.id) || x.id === o.id).map((x) => x.id)))}
                        aria-label={fill(t.include, { name: o.point })}
                        className="mt-0.5 size-[18px] shrink-0 accent-[var(--primary)]"
                      />
                      <span className={cn('text-[13.5px] leading-snug', inc ? 'text-foreground' : 'text-muted-foreground line-through')}>
                        <span className="mr-1.5 tabular-nums text-subtle-foreground">{i + 1}.</span>
                        {o.point}
                      </span>
                    </label>
                  </li>
                );
              })}
            </Stagger>
            <div className="border-t border-border p-3">
              <button type="button" onClick={start} disabled={writing || !picked.length} className={cn(primaryBtn, 'w-full disabled:opacity-60')}>
                <Icon name={step >= picked.length ? 'refresh' : 'sparkle'} size={15} className={cn(writing && 'animate-spin')} />
                {writing ? fill(t.writing, { n: step + 1, total: picked.length }) : step >= picked.length && step > 0 ? t.rewriteDraft : t.write}
              </button>
            </div>
          </div>
        </Reveal>
        <Reveal delay={160}>
          <Paper doc={doc}>
            <p className="mb-3 text-[12px] font-medium text-subtle-foreground">{t.draft}</p>
            <div className={prose}>
              {picked.map((o, i) => {
                const full = i < step;
                const now = i === step && writing;
                return (
                  <p
                    key={o.id}
                    onPointerEnter={() => setHover(o.id)}
                    onPointerLeave={() => setHover(null)}
                    className={cn('relative -mx-3 rounded-lg px-3 py-1 transition-colors duration-300', hover === o.id && 'bg-accent/70')}
                  >
                    <span aria-hidden className={cn('absolute -left-1 top-2.5 hidden h-[calc(100%-1.25rem)] w-0.5 rounded-full transition-colors sm:block', hover === o.id ? 'bg-primary' : 'bg-transparent')} />
                    {/* The finished text always holds the height, so nothing moves while it writes */}
                    <span className={cn('relative block', !full && !now && 'overflow-hidden')}>
                      <span aria-hidden={!full || undefined} className={full ? undefined : "invisible"}>{o.draft}</span>
                      {now && (
                        <span className="absolute inset-0">
                          {shown}
                          <span aria-hidden className="ml-0.5 inline-block h-[1.05em] w-0.5 translate-y-[0.18em] animate-kit-pulse bg-primary" />
                        </span>
                      )}
                      {!full && !now && (
                        <span aria-hidden className="absolute inset-0 block space-y-3 pt-2.5">
                          <span className="block h-2.5 w-11/12 rounded-full bg-[color-mix(in_oklab,var(--foreground)_7%,transparent)]" />
                          <span className="block h-2.5 w-4/5 rounded-full bg-[color-mix(in_oklab,var(--foreground)_7%,transparent)]" />
                          <span className="block h-2.5 w-2/3 rounded-full bg-[color-mix(in_oklab,var(--foreground)_7%,transparent)]" />
                        </span>
                      )}
                    </span>
                  </p>
                );
              })}
            </div>
          </Paper>
          <p className="mt-3 flex items-start gap-2 px-1 text-[12.5px] text-muted-foreground">
            <Icon name="info" size={14} className="mt-px shrink-0" />
            {t.review}
          </p>
        </Reveal>
      </div>
    </Stage>
  );
}

/* ------------------------------------------------------------------ */

/**
 * Writing help in a document: inline suggestions by kind, rewriting in a
 * chosen tone, tracked changes to accept or reject, a toolbar on the
 * selected words and a draft written point by point from an outline.
 */
export function WritingAssistant({ variant = 'inline-suggestions', labels, ...props }: WritingAssistantProps) {
  const t = useTexts(TEXTS, labels);
  const p: P = { ...props, t };
  const body = (() => {
    switch (variant) {
      case 'rewrite-tone':
        return <RewriteTone {...p} />;
      case 'diff-review':
        return <DiffReview {...p} />;
      case 'selection-toolbar':
        return <SelectionToolbar {...p} />;
      case 'outline-draft':
        return <OutlineDraft {...p} />;
      default:
        return <InlineSuggestions {...p} />;
    }
  })();
  return (
    <>
      <Style />
      {body}
    </>
  );
}

Frequent questions

How do I install Writing assistant?

With aiw add @ai-website/writing-assistant. The command puts components/ui/writing-assistant.tsx into your project, the code is yours from then on. It brings along icon, reveal and motion. It needs no further npm packages.

Which variants does Writing assistant have?

5 variants, Inline suggestions, Rewrite in a tone, Review changes, Selection toolbar and Draft from an outline. You pick one with the variant prop, for example variant="rewrite-tone".

Can I translate the texts of Writing assistant?

Yes. Writing assistant carries 42 texts of its own in English and German, such as “Suggestions”, “Grammar” and “Clarity”. The language follows the KitProvider, single texts change through the labels prop.

Can an AI assistant build with Writing assistant?

Yes. Through the MCP server of the aiw CLI, Claude, Cursor, GitHub Copilot, Windsurf, Codex and Gemini find Writing assistant with aiw_components and install it with aiw_add @ai-website/writing-assistant. Name the variant in your prompt, for example variant="inline-suggestions", and the assistant writes your content straight into the props.

Can I adjust Writing assistant without code?

Yes, in the Studio. All 5 variants are editable there, texts, lists and switches. The Studio writes the matching WritingAssistant code to copy.

Often searched

Jump to

Copied to the clipboard