Customize Behavior

addComment

Create a comment annotation anchored to the text range from a TextSelectedEvent.

• Params: RewriterAddCommentRequest
• Returns: Promise<RewriterAddCommentResponse>

React / Next.js

const rewriterElement = client.getRewriterElement();

const result = await rewriterElement.addComment({ text: 'Consider simplifying this.', event });

if (result.success) {
  console.log('Created annotation:', result.annotationId);
}

Other Frameworks

const rewriterElement = Velt.getRewriterElement();

const result = await rewriterElement.addComment({ text: 'Consider simplifying this.', event });

if (result.success) {
  console.log('Created annotation:', result.annotationId);
}

askAi

Send a text-generation prompt to any AI model via Velt’s proxy. The provider is resolved automatically from the model name prefix (gpt-*/o1-*/o3-*/o4-* → OpenAI, claude-* → Anthropic, gemini-* → Gemini).

• Params: RewriterAskAiRequest
• Returns: Promise<RewriterAskAiResponse>

React / Next.js

const rewriterElement = client.getRewriterElement();

const response = await rewriterElement.askAi({
  model: 'gemini-2.5-flash',
  prompt: 'Make it more formal',
  selectedText: event.text,
});

if (response.success) {
  console.log('AI output:', response.text);
}

Other Frameworks

const rewriterElement = Velt.getRewriterElement();

const response = await rewriterElement.askAi({
  model: 'gemini-2.5-flash',
  prompt: 'Make it more formal',
  selectedText: event.text,
});

if (response.success) {
  console.log('AI output:', response.text);
}

enableRewriter

React / Next.js

const rewriterElement = client.getRewriterElement();
rewriterElement.enableRewriter();
rewriterElement.disableRewriter(); //to disable

Other Frameworks

if (Velt) {
  const rewriterElement = Velt.getRewriterElement();
  rewriterElement.enableRewriter();
  rewriterElement.disableRewriter(); //to disable
}

on

Subscribe to Rewriter events. Supports 'textSelected' to receive a TextSelectedEvent whenever a user selects text in a Rewriter-enabled region.

• Params: action: 'textSelected'
• Returns: Observable<TextSelectedEvent>

React / Next.js

const rewriterElement = client.getRewriterElement();

rewriterElement.on('textSelected').subscribe((event) => {
  console.log('Selected text:', event.text);
});

Other Frameworks

const rewriterElement = Velt.getRewriterElement();

rewriterElement.on('textSelected').subscribe((event) => {
  console.log('Selected text:', event.text);
});

replaceText

Replace the DOM text identified by a TextSelectedEvent with new text.

• Params: RewriterReplaceTextRequest
• Returns: Promise<RewriterReplaceTextResponse>

React / Next.js

const rewriterElement = client.getRewriterElement();

const result = await rewriterElement.replaceText({ text: 'Replacement text', event });

if (result.success) {
  console.log('Replaced:', result.originalText, '→', result.replacedText);
}

Other Frameworks

const rewriterElement = Velt.getRewriterElement();

const result = await rewriterElement.replaceText({ text: 'Replacement text', event });

if (result.success) {
  console.log('Replaced:', result.originalText, '→', result.replacedText);
}