Text Editor¶

Open the native Lumiverse expanded text editor modal on the user's frontend. The editor provides full-screen editing with macro syntax highlighting ({{macros}} are color-coded and auto-completed). The call blocks until the user closes the editor.

No permission is required. This is a free-tier utility like Toast Notifications.

Usage¶

const result = await spindle.textEditor.open({
  title: 'Edit System Prompt',
  value: currentText,
})

if (!result.cancelled) {
  currentText = result.text
  spindle.toast.success('Prompt updated')
}

The returned Promise resolves when the user either confirms (closes normally) or cancels (presses Escape or clicks outside). It never rejects.

Minimal Call¶

All options are optional — calling with no arguments opens an empty editor with the default title:

const { text, cancelled } = await spindle.textEditor.open()

With Placeholder¶

const result = await spindle.textEditor.open({
  title: 'Author\'s Note',
  placeholder: 'Write context that should be injected near the end of the prompt...',
})

Options¶

Result¶

Behavior¶

• The editor opens as a full-screen modal in the Lumiverse frontend, overlaying the chat view.
• Macro highlighting is enabled by default — {{user}}, {{char}}, {{random}} etc. are syntax-colored.
• Only one text editor can be open at a time across all extensions. If another extension already has an editor open, the call will wait until the previous editor is closed.
• The editor is rendered by the Lumiverse host — it automatically inherits the user's theme, font scale, and glass mode settings.

Example: Editable Configuration¶

spindle.onFrontendMessage(async (msg) => {
  if (msg.type === 'edit-template') {
    const current = await spindle.userStorage.getText('template.txt', {
      fallback: 'Default template with {{char}} and {{user}}',
    })

    const result = await spindle.textEditor.open({
      title: 'Edit Response Template',
      value: current,
      placeholder: 'Enter your template. Macros like {{char}} will be resolved at runtime.',
    })

    if (!result.cancelled) {
      await spindle.userStorage.setText('template.txt', result.text)
      spindle.toast.success('Template saved')
    }
  }
})