View vs edit mode

Default: view mode

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

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

Display-only (export chrome, no Edit)

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

Same view ball and exports, but Edit is hidden and enterEditMode() is a no-op. Use for dashboards that should stay read-only.

Open the editor immediately

new Insight('#chart', {
  editable: true,
  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',
  chartData,
});

Stays in edit for the life of the mount: no Done control, no morph ball. 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) and allowEdit is not false.

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.