View vs edit

Default: view mode

new Insight('#chart', { persist: false, chartData });

• Chart draws immediately
• No formatting toolbar
• Hover the ChartBuddy ball for Download, Drag to slide, and Edit

Open the editor immediately

new Insight('#chart', {
  editable: true,
  persist: false,
  chartData,
});

Boots in edit with toggle chrome (Done / morph). Users can leave edit and return to view.

Always-on editor (no mode chrome)

new Insight('#chart', {
  editSession: 'locked',
  persist: false,
  chartData,
});

Stays in edit for the life of the mount: no Done control, no morph ball, no enter-edit glare. enterEditMode() / exitEditMode() are no-ops. Use this when the host page owns the surrounding UI (marketing demos, dialogs).

Switch at runtime

await insight.enterEditMode();
insight.mode; // 'edit'

await insight.exitEditMode(); // or use Done on the chrome ball
insight.mode; // 'view'

Only applies when editSession is 'toggle' (the default).

What edit mode is for

Interactive formatting: axes, colors, annotations, orientation, and the rest of the ChartBuddy editor. The embed package has no spreadsheet UI — you edit styling, not the underlying data grid.