@barocss/math-editor 0.2.1 → 0.5.0

package/dist/editor-labels.d.ts

@@ -6,4 +6,3 @@ export declare function createEditorLabels(locale: MathLocale): {
     slot: (parent: string, kind: StructureKind, index: number) => string;
     grid: (parent: string, kind: "matrix" | "aligned" | "cases", index: number, columns: number) => string;
 };
-//# sourceMappingURL=editor-labels.d.ts.map

package/dist/editor-labels.js

@@ -70,4 +70,3 @@ export function createEditorLabels(locale) {
         })}`,
     };
 }
-//# sourceMappingURL=editor-labels.js.map

package/dist/enter-policy.d.ts

@@ -8,4 +8,3 @@ export interface MathEnterContext {
 }
 /** Keep host completion separate from internal grid editing and suggestion acceptance. */
 export declare function mathEnterAction(context: MathEnterContext): 'suggestion' | 'grid-row' | 'commit' | 'newline' | 'none';
-//# sourceMappingURL=enter-policy.d.ts.map

package/dist/enter-policy.js

@@ -10,4 +10,3 @@ export function mathEnterAction(context) {
         return context.gridKind === 'matrix' ? 'none' : 'grid-row';
     return 'newline';
 }
-//# sourceMappingURL=enter-policy.js.map

package/dist/fences.d.ts

@@ -8,4 +8,3 @@ export declare function fences(node: {
     right?: FenceCharacter;
 }): readonly ["(" | ")" | "[" | "]" | "{" | "}" | "⟨" | "⟩" | "|" | "‖" | ".", "(" | ")" | "[" | "]" | "{" | "}" | "⟨" | "⟩" | "|" | "‖" | "."];
 export declare function fenceLatex(value: FenceCharacter): string;
-//# sourceMappingURL=fences.d.ts.map

package/dist/fences.js

@@ -18,4 +18,3 @@ export function fences(node) {
 export function fenceLatex(value) {
     return ({ '‖': '\\Vert ', '{': '\\{', '}': '\\}', '⟨': '\\langle ', '⟩': '\\rangle ' }[value] ?? value);
 }
-//# sourceMappingURL=fences.js.map

package/dist/i18n.d.ts

@@ -17,4 +17,3 @@ export declare const mathLocaleAliases: (locale: string, id: string) => readonly
 /** A small dictionary resolver: lookup, fallback and named interpolation. No rendering or fetching. */
 export declare function translate(locale: MathLocale, key: string, parameters?: MathMessageParameters): string;
 export declare const mathEnglishMessages: Readonly<Record<string, string>>;
-//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.js

@@ -55,4 +55,3 @@ function interpolate(template, parameters) {
 export const mathEnglishMessages = Object.freeze({
     ...english.messages,
 });
-//# sourceMappingURL=i18n.js.map

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './model.js';
 export { MathEditor, type MathEditorProps, type MathEditorHandle } from './math-editor.js';
 export { findSuggestions, acceptSuggestion, mathStructures, type MathSuggestion, } from './suggestions.js';
 export * from './matrix.js';
+export * from './matrix-range.js';
 export * from './lines.js';
 export * from './tokens.js';
 export * from './range.js';
@@ -11,4 +12,6 @@ export * from './templates.js';
 export { mathSymbols } from './symbols.js';
 export * from './latex.js';
 export * from './document-codec.js';
-//# sourceMappingURL=index.d.ts.map
+export * from './preferences.js';
+export * from './presentation.js';
+export * from './latex-insertion.js';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './model.js';
 export { MathEditor } from './math-editor.js';
 export { findSuggestions, acceptSuggestion, mathStructures, } from './suggestions.js';
 export * from './matrix.js';
+export * from './matrix-range.js';
 export * from './lines.js';
 export * from './tokens.js';
 export * from './range.js';
@@ -11,4 +12,6 @@ export * from './templates.js';
 export { mathSymbols } from './symbols.js';
 export * from './latex.js';
 export * from './document-codec.js';
-//# sourceMappingURL=index.js.map
+export * from './preferences.js';
+export * from './presentation.js';
+export * from './latex-insertion.js';

package/dist/latex-insertion.d.ts

@@ -0,0 +1,12 @@
+import { type LatexImportOptions, type LatexParseResult } from './latex.js';
+import { type MathState } from './model.js';
+import { type MathRange } from './range.js';
+export type LatexInsertionResult = (Extract<LatexParseResult, {
+    ok: true;
+}> & {
+    state: MathState;
+}) | Extract<LatexParseResult, {
+    ok: false;
+}>;
+/** Parse first, then insert at the caret/range. Rejected input never changes the source tree. */
+export declare function insertLatex(state: MathState, source: string, range?: MathRange, options?: LatexImportOptions): LatexInsertionResult;

package/dist/latex-insertion.js

@@ -0,0 +1,26 @@
+import { parseLatex } from './latex.js';
+import { documentRows } from './model.js';
+import { pasteFragment } from './range.js';
+/** Parse first, then insert at the caret/range. Rejected input never changes the source tree. */
+export function insertLatex(state, source, range, options) {
+    const parsed = parseLatex(source, options);
+    if (!parsed.ok)
+        return parsed;
+    const next = source.trim()
+        ? pasteFragment(state, { version: 1, rows: documentRows(parsed.document) }, range)
+        : state;
+    if (next === state)
+        return {
+            ok: false,
+            source,
+            diagnostics: [
+                {
+                    code: 'unsupported-structure',
+                    message: 'This input cannot be inserted at the current selection.',
+                    start: 0,
+                    end: source.length,
+                },
+            ],
+        };
+    return { ...parsed, state: next };
+}

package/dist/latex-paste-panel.d.ts

@@ -0,0 +1,3 @@
+import { mountLatexPanel } from './dom/latex-panel.js';
+/** Both renderers use the same paste form and diagnostic behavior. */
+export declare function LatexPastePanel(props: Parameters<typeof mountLatexPanel>[1]): import("react/jsx-runtime").JSX.Element;

package/dist/latex-paste-panel.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLayoutEffect, useRef } from 'react';
+import { mountLatexPanel } from './dom/latex-panel.js';
+/** Both renderers use the same paste form and diagnostic behavior. */
+export function LatexPastePanel(props) {
+    const host = useRef(null);
+    const current = useRef(props);
+    current.current = props;
+    useLayoutEffect(() => {
+        const panel = mountLatexPanel(host.current, {
+            locale: props.locale,
+            onInsert: (source) => current.current.onInsert(source),
+            onClose: () => current.current.onClose(),
+        });
+        return () => panel.destroy();
+    }, [props.locale]);
+    return _jsx("div", { ref: host });
+}

package/dist/latex.d.ts

@@ -23,4 +23,3 @@ export interface LatexImportOptions {
 }
 /** Parse without changing editor state. Failures retain the complete original source. */
 export declare function parseLatex(source: string, options?: LatexImportOptions): LatexParseResult;
-//# sourceMappingURL=latex.d.ts.map

package/dist/latex.js

@@ -391,6 +391,17 @@ class LatexParser {
             return row(command);
         if (command === 'backslash')
             return row('\\');
+        if (command === 'char') {
+            // Canonical math-mode literal caret/tilde output. This is intentionally
+            // bounded; arbitrary TeX character codes are not part of the model API.
+            this.skip();
+            const match = this.source.slice(this.at, this.end).match(/^"([0-9a-f]+)/i);
+            const code = match ? Number.parseInt(match[1], 16) : NaN;
+            if (code !== 0x5e && code !== 0x7e)
+                this.fail('unsupported-command', 'Only literal caret and tilde character codes are supported.', start);
+            this.at += match[0].length;
+            return row(String.fromCodePoint(code));
+        }
         if (command === 'textasciicircum' || command === 'textasciitilde') {
             this.skip();
             if (!this.starts('{}'))
@@ -686,4 +697,3 @@ export function parseLatex(source, options = {}) {
         throw error;
     }
 }
-//# sourceMappingURL=latex.js.map

package/dist/lines.d.ts

@@ -4,4 +4,3 @@ export declare function splitLine(state: MathState): MathState;
 /** Backspace at the start of a top-level line merges it with the previous line. */
 export declare function joinPreviousLine(state: MathState): MathState;
 export declare function moveLineVertical(state: MathState, direction: -1 | 1): MathState;
-//# sourceMappingURL=lines.d.ts.map

package/dist/lines.js

@@ -48,4 +48,3 @@ export function moveLineVertical(state, direction) {
     const offset = Math.min(state.caret.start, target.text.length);
     return { ...state, caret: { id: target.id, start: offset, end: offset } };
 }
-//# sourceMappingURL=lines.js.map

package/dist/locales/en.js

@@ -315,7 +315,45 @@ export default {
         "structure.xleftarrow": "Labeled left arrow",
         "structure.arrowLabelsDetail": "Edit labels above and below a stretchy arrow",
         "slot.arrowUpper": "Upper label",
-        "slot.arrowLower": "Lower label"
+        "slot.arrowLower": "Lower label",
+        "matrix.selectCells": "Select cells",
+        "matrix.selectAll": "Select all cells",
+        "matrix.transpose": "Transpose matrix",
+        "matrix.rangeHint": "{rows} × {columns} cells selected · Shift+arrows extends · Copy / Paste · Delete clears · Enter edits",
+        "matrix.pasteRejected": "The cell sizes do not match, the clipboard is invalid, or the result exceeds 20 × 20. The matrix was not changed.",
+        "clipboard.latexTitle": "Paste as LaTeX",
+        "clipboard.latexHint": "Paste LaTeX here. Insert replaces the selected range or inserts at the caret. Ctrl/Cmd+Enter inserts.",
+        "clipboard.latexInsert": "Insert formula",
+        "clipboard.latexError": "Cannot insert LaTeX",
+        "clipboard.latexShortcut": "Alt+Shift+V: Paste as LaTeX",
+        "quick.title": "Recent & favorites",
+        "quick.filter": "Show items",
+        "quick.all": "All symbols and templates",
+        "quick.recent": "Recently used",
+        "quick.favorites": "Favorites",
+        "quick.favorite": "Favorite",
+        "quick.empty": "No items here yet.",
+        "presentation.title": "Structure settings",
+        "presentation.fence": "Brackets",
+        "presentation.size": "Fraction size",
+        "presentation.limits": "Limit placement",
+        "presentation.default": "Automatic",
+        "presentation.display": "Display size",
+        "presentation.text": "Text size",
+        "presentation.aboveBelow": "Above and below",
+        "presentation.side": "Beside operator",
+        "suggestion.transform": "Change to {kind}",
+        "suggestion.transformRootDetail": "Keep the radicand. A square root requires an empty index or 2.",
+        "context.label": "Structure tools",
+        "context.current": "Editing: {kind}",
+        "context.editIndex": "Edit index",
+        "context.keyboardHint": "F6: tools · Esc: back to input",
+        "context.squareIndexRequired": "Change the index to 2 or clear it to use a square root.",
+        "context.root": "Square root",
+        "context.indexedRoot": "Indexed root",
+        "context.fenceKeyboardHint": "F6: tools · ← →: choose · Enter: apply · Esc: back to input",
+        "suggestion.transformFence": "Change brackets: {kind}",
+        "suggestion.transformFenceDetail": "Keep the enclosed formula and cursor position"
     },
     "aliases": {}
 };

package/dist/locales/en.json

@@ -314,7 +314,45 @@
         "structure.xleftarrow": "Labeled left arrow",
         "structure.arrowLabelsDetail": "Edit labels above and below a stretchy arrow",
         "slot.arrowUpper": "Upper label",
-        "slot.arrowLower": "Lower label"
+        "slot.arrowLower": "Lower label",
+        "matrix.selectCells": "Select cells",
+        "matrix.selectAll": "Select all cells",
+        "matrix.transpose": "Transpose matrix",
+        "matrix.rangeHint": "{rows} × {columns} cells selected · Shift+arrows extends · Copy / Paste · Delete clears · Enter edits",
+        "matrix.pasteRejected": "The cell sizes do not match, the clipboard is invalid, or the result exceeds 20 × 20. The matrix was not changed.",
+        "clipboard.latexTitle": "Paste as LaTeX",
+        "clipboard.latexHint": "Paste LaTeX here. Insert replaces the selected range or inserts at the caret. Ctrl/Cmd+Enter inserts.",
+        "clipboard.latexInsert": "Insert formula",
+        "clipboard.latexError": "Cannot insert LaTeX",
+        "clipboard.latexShortcut": "Alt+Shift+V: Paste as LaTeX",
+        "quick.title": "Recent & favorites",
+        "quick.filter": "Show items",
+        "quick.all": "All symbols and templates",
+        "quick.recent": "Recently used",
+        "quick.favorites": "Favorites",
+        "quick.favorite": "Favorite",
+        "quick.empty": "No items here yet.",
+        "presentation.title": "Structure settings",
+        "presentation.fence": "Brackets",
+        "presentation.size": "Fraction size",
+        "presentation.limits": "Limit placement",
+        "presentation.default": "Automatic",
+        "presentation.display": "Display size",
+        "presentation.text": "Text size",
+        "presentation.aboveBelow": "Above and below",
+        "presentation.side": "Beside operator",
+        "suggestion.transform": "Change to {kind}",
+        "suggestion.transformRootDetail": "Keep the radicand. A square root requires an empty index or 2.",
+        "context.label": "Structure tools",
+        "context.current": "Editing: {kind}",
+        "context.editIndex": "Edit index",
+        "context.keyboardHint": "F6: tools · Esc: back to input",
+        "context.squareIndexRequired": "Change the index to 2 or clear it to use a square root.",
+        "context.root": "Square root",
+        "context.indexedRoot": "Indexed root",
+        "context.fenceKeyboardHint": "F6: tools · ← →: choose · Enter: apply · Esc: back to input",
+        "suggestion.transformFence": "Change brackets: {kind}",
+        "suggestion.transformFenceDetail": "Keep the enclosed formula and cursor position"
     },
     "aliases": {}
 }

package/dist/locales/ko.js

@@ -315,7 +315,45 @@ export default {
         "structure.xleftarrow": "왼쪽 설명 화살표",
         "structure.arrowLabelsDetail": "길이가 늘어나는 화살표 위·아래 설명 편집",
         "slot.arrowUpper": "위 설명",
-        "slot.arrowLower": "아래 설명"
+        "slot.arrowLower": "아래 설명",
+        "matrix.selectCells": "셀 선택",
+        "matrix.selectAll": "모든 셀 선택",
+        "matrix.transpose": "행렬 전치",
+        "matrix.rangeHint": "{rows} × {columns} 셀 선택 · Shift+방향키로 확장 · 복사 / 붙여넣기 · Delete로 비우기 · Enter로 편집",
+        "matrix.pasteRejected": "셀 크기가 맞지 않거나 클립보드가 올바르지 않거나 20 × 20을 초과합니다. 행렬은 그대로 유지됩니다.",
+        "clipboard.latexTitle": "LaTeX로 붙여넣기",
+        "clipboard.latexHint": "LaTeX를 붙여넣으세요. 선택 영역을 바꾸거나 커서 위치에 넣습니다. Ctrl/Cmd+Enter로 삽입합니다.",
+        "clipboard.latexInsert": "수식 삽입",
+        "clipboard.latexError": "LaTeX를 넣을 수 없습니다",
+        "clipboard.latexShortcut": "Alt+Shift+V: LaTeX로 붙여넣기",
+        "quick.title": "최근 사용·즐겨찾기",
+        "quick.filter": "목록 보기",
+        "quick.all": "모든 기호와 템플릿",
+        "quick.recent": "최근 사용",
+        "quick.favorites": "즐겨찾기",
+        "quick.favorite": "즐겨찾기",
+        "quick.empty": "아직 항목이 없습니다.",
+        "presentation.title": "구조 설정",
+        "presentation.fence": "괄호 종류",
+        "presentation.size": "분수 크기",
+        "presentation.limits": "첨자 배치",
+        "presentation.default": "자동",
+        "presentation.display": "큰 표시",
+        "presentation.text": "작은 표시",
+        "presentation.aboveBelow": "위·아래",
+        "presentation.side": "오른쪽",
+        "suggestion.transform": "{kind}으로 변형",
+        "suggestion.transformRootDetail": "루트 안의 수식을 유지합니다. 제곱근으로 바꾸려면 차수가 2이거나 비어 있어야 합니다.",
+        "context.label": "구조 편집 도구",
+        "context.current": "현재 구조: {kind}",
+        "context.editIndex": "차수 편집",
+        "context.keyboardHint": "F6: 도구로 이동 · Esc: 입력으로",
+        "context.squareIndexRequired": "제곱근으로 바꾸려면 차수를 2로 바꾸거나 비워 주세요.",
+        "context.root": "제곱근",
+        "context.indexedRoot": "n제곱근",
+        "context.fenceKeyboardHint": "F6: 도구로 이동 · ← →: 선택 · Enter: 적용 · Esc: 입력으로",
+        "suggestion.transformFence": "괄호 변경: {kind}",
+        "suggestion.transformFenceDetail": "안의 수식과 커서 위치를 유지합니다"
     },
     "aliases": {
         "function-sin": ["사인"],

package/dist/locales/ko.json

@@ -314,7 +314,45 @@
         "structure.xleftarrow": "왼쪽 설명 화살표",
         "structure.arrowLabelsDetail": "길이가 늘어나는 화살표 위·아래 설명 편집",
         "slot.arrowUpper": "위 설명",
-        "slot.arrowLower": "아래 설명"
+        "slot.arrowLower": "아래 설명",
+        "matrix.selectCells": "셀 선택",
+        "matrix.selectAll": "모든 셀 선택",
+        "matrix.transpose": "행렬 전치",
+        "matrix.rangeHint": "{rows} × {columns} 셀 선택 · Shift+방향키로 확장 · 복사 / 붙여넣기 · Delete로 비우기 · Enter로 편집",
+        "matrix.pasteRejected": "셀 크기가 맞지 않거나 클립보드가 올바르지 않거나 20 × 20을 초과합니다. 행렬은 그대로 유지됩니다.",
+        "clipboard.latexTitle": "LaTeX로 붙여넣기",
+        "clipboard.latexHint": "LaTeX를 붙여넣으세요. 선택 영역을 바꾸거나 커서 위치에 넣습니다. Ctrl/Cmd+Enter로 삽입합니다.",
+        "clipboard.latexInsert": "수식 삽입",
+        "clipboard.latexError": "LaTeX를 넣을 수 없습니다",
+        "clipboard.latexShortcut": "Alt+Shift+V: LaTeX로 붙여넣기",
+        "quick.title": "최근 사용·즐겨찾기",
+        "quick.filter": "목록 보기",
+        "quick.all": "모든 기호와 템플릿",
+        "quick.recent": "최근 사용",
+        "quick.favorites": "즐겨찾기",
+        "quick.favorite": "즐겨찾기",
+        "quick.empty": "아직 항목이 없습니다.",
+        "presentation.title": "구조 설정",
+        "presentation.fence": "괄호 종류",
+        "presentation.size": "분수 크기",
+        "presentation.limits": "첨자 배치",
+        "presentation.default": "자동",
+        "presentation.display": "큰 표시",
+        "presentation.text": "작은 표시",
+        "presentation.aboveBelow": "위·아래",
+        "presentation.side": "오른쪽",
+        "suggestion.transform": "{kind}으로 변형",
+        "suggestion.transformRootDetail": "루트 안의 수식을 유지합니다. 제곱근으로 바꾸려면 차수가 2이거나 비어 있어야 합니다.",
+        "context.label": "구조 편집 도구",
+        "context.current": "현재 구조: {kind}",
+        "context.editIndex": "차수 편집",
+        "context.keyboardHint": "F6: 도구로 이동 · Esc: 입력으로",
+        "context.squareIndexRequired": "제곱근으로 바꾸려면 차수를 2로 바꾸거나 비워 주세요.",
+        "context.root": "제곱근",
+        "context.indexedRoot": "n제곱근",
+        "context.fenceKeyboardHint": "F6: 도구로 이동 · ← →: 선택 · Enter: 적용 · Esc: 입력으로",
+        "suggestion.transformFence": "괄호 변경: {kind}",
+        "suggestion.transformFenceDetail": "안의 수식과 커서 위치를 유지합니다"
     },
     "aliases": {
         "function-sin": ["사인"],

package/dist/math-editor-toolbar.d.ts

@@ -8,6 +8,7 @@ interface MathEditorToolbarProps {
     excludedStructures?: readonly StructureKind[];
     composing: boolean;
     hasRange: boolean;
+    cellRange?: boolean;
     canWrap: boolean;
     canUndo: boolean;
     canRedo: boolean;
@@ -17,11 +18,12 @@ interface MathEditorToolbarProps {
     onTemplate: (id: string) => void;
     onToggleSymbols: () => void;
     onInsertSymbol: (glyph: string) => void;
+    onQuick: () => void;
+    onPasteLatex: () => void;
     onUndo: () => void;
     onRedo: () => void;
     children?: ReactNode;
 }
 /** Presentation-only toolbar. The editor keeps selection, composition and history ownership. */
-export declare function MathEditorToolbar({ locale, kinds, maxItems, excludedStructures, composing, hasRange, canWrap, canUndo, canRedo, symbolsOpen, onInsertStructure, onMatrixPreset, onTemplate, onToggleSymbols, onInsertSymbol, onUndo, onRedo, children, }: MathEditorToolbarProps): import("react/jsx-runtime").JSX.Element;
+export declare function MathEditorToolbar({ locale, kinds, maxItems, excludedStructures, composing, hasRange, cellRange, canWrap, canUndo, canRedo, symbolsOpen, onInsertStructure, onMatrixPreset, onTemplate, onToggleSymbols, onInsertSymbol, onQuick, onPasteLatex, onUndo, onRedo, children, }: MathEditorToolbarProps): import("react/jsx-runtime").JSX.Element;
 export {};
-//# sourceMappingURL=math-editor-toolbar.d.ts.map

package/dist/math-editor-toolbar.js

@@ -12,14 +12,13 @@ const symbols = [
     { label: 'symbol.infinity', value: '∞' },
 ];
 /** Presentation-only toolbar. The editor keeps selection, composition and history ownership. */
-export function MathEditorToolbar({ locale, kinds, maxItems = 8, excludedStructures = [], composing, hasRange, canWrap, canUndo, canRedo, symbolsOpen, onInsertStructure, onMatrixPreset, onTemplate, onToggleSymbols, onInsertSymbol, onUndo, onRedo, children, }) {
+export function MathEditorToolbar({ locale, kinds, maxItems = 8, excludedStructures = [], composing, hasRange, cellRange = false, canWrap, canUndo, canRedo, symbolsOpen, onInsertStructure, onMatrixPreset, onTemplate, onToggleSymbols, onInsertSymbol, onQuick, onPasteLatex, onUndo, onRedo, children, }) {
     const [expanded, setExpanded] = useState(false);
     const visibleCount = Math.max(0, Math.floor(Number.isFinite(maxItems) ? maxItems : 8));
     const items = mathStructures.filter((s) => s.kind && !excludedStructures.includes(s.kind) && (!kinds || kinds.includes(s.kind)));
     const t = (key, parameters) => translate(locale, key, parameters);
-    return (_jsxs("div", { className: "me-tools", role: "toolbar", "aria-label": t('toolbar.label'), children: [(expanded ? items : items.slice(0, visibleCount)).map((s) => (_jsxs("button", { type: "button", "aria-label": t(s.label), disabled: composing || (hasRange && (!canWrap || !wrappingKinds.includes(s.kind))), onMouseDown: (event) => event.preventDefault(), onClick: () => onInsertStructure(s.kind), children: [_jsx("span", { children: s.glyph }), t(s.label)] }, s.kind))), expanded && (_jsxs(_Fragment, { children: [_jsxs("select", { disabled: composing || hasRange, className: "me-matrix-size", "aria-label": t('matrix.preset'), value: "", onChange: (event) => {
+    return (_jsxs("div", { className: "me-tools", role: "toolbar", "aria-label": t('toolbar.label'), children: [(expanded ? items : items.slice(0, visibleCount)).map((s) => (_jsxs("button", { type: "button", "aria-label": t(s.label), disabled: composing || (hasRange && (!canWrap || !wrappingKinds.includes(s.kind))), onMouseDown: (event) => event.preventDefault(), onClick: () => onInsertStructure(s.kind), children: [_jsx("span", { children: s.glyph }), t(s.label)] }, s.kind))), expanded && (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", "data-math-tool": "quick", disabled: composing || cellRange, onMouseDown: (event) => event.preventDefault(), onClick: onQuick, children: t('quick.title') }), _jsx("button", { type: "button", "data-math-tool": "paste-latex", disabled: composing || cellRange, onMouseDown: (event) => event.preventDefault(), onClick: onPasteLatex, title: t('clipboard.latexShortcut'), children: t('clipboard.latexTitle') }), _jsxs("select", { disabled: composing || hasRange, className: "me-matrix-size", "aria-label": t('matrix.preset'), value: "", onChange: (event) => {
                             const value = event.target.value;
                             onMatrixPreset(value);
-                        }, children: [_jsx("option", { value: "", disabled: true, children: t('matrix.presetPlaceholder') }), [2, 3, 4].map((size) => (_jsx("option", { value: size, children: t('matrix.insert', { rows: size, columns: size }) }, size))), [2, 3, 4].map((size) => (_jsx("option", { value: `identity-${size}`, children: t('matrix.insertIdentity', { rows: size, columns: size }) }, `identity-${size}`)))] }), _jsxs("select", { className: "me-matrix-size", "aria-label": t('template.label'), value: "", disabled: composing, onChange: (event) => onTemplate(event.target.value), children: [_jsx("option", { value: "", disabled: true, children: t('template.placeholder') }), mathTemplates.map((item) => (_jsx("option", { value: item.id, children: t(item.label, item.labelParameters) }, item.id)))] }), _jsx("button", { type: "button", "aria-expanded": symbolsOpen, disabled: composing, onClick: onToggleSymbols, children: t('symbols.title') }), _jsx("span", { className: "me-divider" }), symbols.map((s) => (_jsx("button", { type: "button", "aria-label": t(s.label), disabled: composing || hasRange, onMouseDown: (event) => event.preventDefault(), onClick: () => onInsertSymbol(s.value), children: s.value }, s.label)))] })), _jsx("button", { type: "button", className: "me-toolbar-toggle", "aria-expanded": expanded, onMouseDown: (event) => event.preventDefault(), onClick: () => setExpanded((value) => !value), children: t(expanded ? 'toolbar.less' : 'toolbar.more') }), _jsx("button", { type: "button", disabled: !canUndo || composing, onMouseDown: (event) => event.preventDefault(), onClick: onUndo, children: t('history.undo') }), _jsx("button", { type: "button", disabled: !canRedo || composing, onMouseDown: (event) => event.preventDefault(), onClick: onRedo, children: t('history.redo') }), children] }));
+                        }, children: [_jsx("option", { value: "", disabled: true, children: t('matrix.presetPlaceholder') }), [2, 3, 4].map((size) => (_jsx("option", { value: size, children: t('matrix.insert', { rows: size, columns: size }) }, size))), [2, 3, 4].map((size) => (_jsx("option", { value: `identity-${size}`, children: t('matrix.insertIdentity', { rows: size, columns: size }) }, `identity-${size}`)))] }), _jsxs("select", { className: "me-matrix-size", "aria-label": t('template.label'), value: "", disabled: composing || cellRange, onChange: (event) => onTemplate(event.target.value), children: [_jsx("option", { value: "", disabled: true, children: t('template.placeholder') }), mathTemplates.map((item) => (_jsx("option", { value: item.id, children: t(item.label, item.labelParameters) }, item.id)))] }), _jsx("button", { type: "button", "aria-expanded": symbolsOpen, disabled: composing || cellRange, onClick: onToggleSymbols, children: t('symbols.title') }), _jsx("span", { className: "me-divider" }), symbols.map((s) => (_jsx("button", { type: "button", "aria-label": t(s.label), disabled: composing || hasRange, onMouseDown: (event) => event.preventDefault(), onClick: () => onInsertSymbol(s.value), children: s.value }, s.label)))] })), _jsx("button", { type: "button", className: "me-toolbar-toggle", "aria-expanded": expanded, onMouseDown: (event) => event.preventDefault(), onClick: () => setExpanded((value) => !value), children: t(expanded ? 'toolbar.less' : 'toolbar.more') }), _jsx("button", { type: "button", disabled: !canUndo || composing, onMouseDown: (event) => event.preventDefault(), onClick: onUndo, children: t('history.undo') }), _jsx("button", { type: "button", disabled: !canRedo || composing, onMouseDown: (event) => event.preventDefault(), onClick: onRedo, children: t('history.redo') }), children] }));
 }
-//# sourceMappingURL=math-editor-toolbar.js.map

package/dist/math-editor.d.ts

@@ -1,3 +1,5 @@
+import { type MathPreferences } from './preferences.js';
+import { type LatexInsertionResult } from './latex-insertion.js';
 import { type LatexParseResult } from './latex.js';
 import { type MathLocale } from './i18n.js';
 import { type ReactNode, type Ref } from 'react';
@@ -5,8 +7,10 @@ import { type MathDocument, type StructureKind } from './model.js';
 export interface MathEditorHandle {
     /** Replace with supported LaTeX as one undoable edit; failures preserve all editor state. */
     importLatex(source: string): LatexParseResult;
+    pasteLatex(source: string): LatexInsertionResult;
 }
 export interface MathEditorProps {
+    preferences?: MathPreferences;
     apiRef?: Ref<MathEditorHandle>;
     /** Start editing at the initial caret when embedded in a host editor. */
     autoFocus?: boolean;
@@ -24,6 +28,8 @@ export interface MathEditorProps {
     toolbar?: boolean | readonly StructureKind[];
     /** Visible structure buttons before More; defaults to 8. */
     toolbarMaxItems?: number;
+    /** Show contextual structure actions below the editing surface. Defaults to true. */
+    contextTools?: boolean;
     /** Host-owned actions rendered at the end of the main toolbar. */
     toolbarEnd?: ReactNode;
     showTokenLegend?: boolean;
@@ -39,5 +45,4 @@ export interface MathEditorProps {
     label?: string;
 }
 /** Native text fields own IME and local text selection; the tree owns structural editing. */
-export declare function MathEditor({ apiRef, autoFocus, enterBehavior, onCommit, onCancel, showPopovers, defaultValue, excludedStructures, multiline, onChange, onExit, label, locale, showLineNumbers, toolbar, toolbarMaxItems, toolbarEnd, showTokenLegend, }: MathEditorProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=math-editor.d.ts.map
+export declare function MathEditor({ preferences: suppliedPreferences, apiRef, autoFocus, enterBehavior, onCommit, onCancel, showPopovers, defaultValue, excludedStructures, multiline, onChange, onExit, label, locale, showLineNumbers, toolbar, toolbarMaxItems, contextTools, toolbarEnd, showTokenLegend, }: MathEditorProps): import("react/jsx-runtime").JSX.Element;