oasis-editor 0.0.147 → 0.0.149

package/dist/core/commands/builtinCommands.d.ts

@@ -1,2 +1,2 @@
-export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageBorder", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape"];
+export declare const OASIS_BUILTIN_COMMANDS: readonly ["selectAll", "insertFootnote", "insertText", "insertEquation", "updateEquation", "insertTableOfContents", "updateTableOfContents", "pastePlainText", "bold", "italic", "underline", "strike", "superscript", "subscript", "link", "unlink", "alignLeft", "alignCenter", "alignRight", "alignJustify", "orderedList", "bulletList", "find", "replace", "toggleTrackChanges", "acceptRevisions", "rejectRevisions", "toggleShowMargins", "toggleShowParagraphMarks", "togglePreciseFonts", "undo", "redo", "pageBreak", "lineBreak", "splitBlock", "setFontFamily", "setFontSize", "increaseFontSize", "decreaseFontSize", "changeTextCase", "clearFormatting", "setColor", "setHighlight", "setTextShading", "setStyleId", "setCharacterStyleId", "setUnderlineStyle", "documentStyles", "print", "copy", "newDocument", "exportDocx", "exportPdf", "importDocument", "insertImage", "editImageAlt", "insertImageCaption", "imageContext", "imageWidthCm", "imageHeightCm", "imageCrop", "imageCropAspect", "imageBorder", "outdent", "indent", "togglePageBreakBefore", "toggleKeepWithNext", "setSpacingAfter", "setSpacingBefore", "setIndentLeft", "setIndentRight", "setIndentFirstLine", "setIndentHanging", "setSpecialIndent", "setParagraphShading", "applyParagraphBorders", "setLineHeight", "setListFormat", "setListStartAt", "toggleOrientation", "setOrientation", "sectionBreakNextPage", "sectionBreakContinuous", "setPageMargins", "tableContext", "tableMerge", "tableSplit", "tableInsertColumnBefore", "tableInsertColumnAfter", "tableDeleteColumn", "tableInsertRowBefore", "tableInsertRowAfter", "tableDeleteRow", "tableCellShading", "tableCellBorders", "tableCellNoBorders", "tableApplyBorderPreset", "toggleTableDrawBorders", "toggleTableGridlines", "tableWidth100", "tableAlignLeft", "tableAlignCenter", "tableAlignRight", "tableSetCellWidth", "tableToggleHeaderRow", "tableToggleTotalRow", "tableToggleBandedRows", "tableToggleFirstColumn", "tableToggleLastColumn", "tableToggleBandedColumns", "setTableStyle", "tableToggleAutoFit", "tableDistributeColumns", "tableDistributeRows", "insertTable", "insertShape", "openSymbolDialog", "openEquationDialog"];
 export type OasisBuiltinCommand = (typeof OASIS_BUILTIN_COMMANDS)[number];

package/dist/core/commands/publicCommandTypes.d.ts

@@ -1,5 +1,5 @@
 import { CommandRef } from './CommandRef.js';
-import { EditorPageMargins } from '../model.js';
+import { EditorPageMargins, EditorMathExpression } from '../model.js';
 import { TextCaseMode } from './text.js';
 import { TableBorderPreset } from './table.js';
 
@@ -20,6 +20,11 @@ export interface SetSpecialIndentPayload {
     kind: "none" | "firstLine" | "hanging";
     value?: number | null;
 }
+/** Payload for inserting text with an optional character font override. */
+export interface InsertTextPayload {
+    text: string;
+    fontFamily?: string | null;
+}
 /**
  * Maps every built-in command name to its expected payload type.
  * Commands with `undefined` payload accept no arguments.
@@ -27,6 +32,12 @@ export interface SetSpecialIndentPayload {
 export interface OasisCommandPayloads {
     selectAll: undefined;
     insertFootnote: undefined;
+    insertText: string | InsertTextPayload;
+    insertEquation: EditorMathExpression;
+    updateEquation: {
+        runId: string;
+        expression: EditorMathExpression;
+    };
     pastePlainText: undefined;
     bold: undefined;
     italic: undefined;
@@ -70,6 +81,7 @@ export interface OasisCommandPayloads {
     documentStyles: undefined;
     print: undefined;
     copy: undefined;
+    newDocument: undefined;
     exportDocx: undefined;
     exportPdf: undefined;
     importDocument: undefined;
@@ -133,6 +145,8 @@ export interface OasisCommandPayloads {
     tableDistributeColumns: undefined;
     tableDistributeRows: undefined;
     insertTable: InsertTablePayload;
+    openSymbolDialog: undefined;
+    openEquationDialog: undefined;
 }
 /** Maps commands to their typed return values. Commands not listed return `unknown`. */
 export interface OasisCommandResults {

package/dist/core/commands/text.d.ts

@@ -1,4 +1,4 @@
-export { moveOrCopySelectionToPosition, insertTextAtSelection, insertPlainTextAtSelection, } from './textEditing.js';
+export { moveOrCopySelectionToPosition, insertTextAtSelection, insertPlainTextAtSelection, insertMathAtSelection, updateMathRun, } from './textEditing.js';
 export { deleteBackward, deleteForward } from './textDeletion.js';
 export { toggleTextStyle, clearSelectedTextFormatting, setTextStyleValue, } from './textFormatting.js';
 export { type TextCaseMode, transformSelectedText, changeSelectedTextCase, } from './textCase.js';

package/dist/core/commands/textEditing.d.ts

@@ -1,7 +1,9 @@
-import { EditorPosition, EditorState, EditorTextStyle } from '../model.js';
+import { EditorPosition, EditorState, EditorTextStyle, EditorMathExpression } from '../model.js';
 
 export declare function moveOrCopySelectionToPosition(state: EditorState, targetPosition: EditorPosition, options?: {
     copy?: boolean;
 }): EditorState;
 export declare function insertTextAtSelection(state: EditorState, text: string, styleOverride?: EditorTextStyle): EditorState;
+export declare function insertMathAtSelection(state: EditorState, expression: EditorMathExpression): EditorState;
+export declare function updateMathRun(state: EditorState, runId: string, expression: EditorMathExpression): EditorState;
 export declare function insertPlainTextAtSelection(state: EditorState, text: string, styleOverride?: EditorTextStyle): EditorState;

package/dist/core/document/clone.d.ts

@@ -1,6 +1,7 @@
-import { EditorBlockNode, EditorParagraphListStyle, EditorParagraphNode, EditorTextBoxData, EditorTextRun } from '../model.js';
+import { EditorBlockNode, EditorParagraphListStyle, EditorParagraphNode, EditorTextBoxData, EditorTextRun, EditorMathExpression } from '../model.js';
 
 export declare function cloneTextBox(textBox: EditorTextBoxData): EditorTextBoxData;
+export declare function cloneMathExpression(expression: EditorMathExpression): EditorMathExpression;
 export declare function cloneRun(run: EditorTextRun): EditorTextRun;
 export declare function cloneParagraph(paragraph: EditorParagraphNode): EditorParagraphNode;
 export declare function cloneParagraphList(list?: EditorParagraphListStyle): EditorParagraphListStyle | undefined;

package/dist/core/math/linear.d.ts

@@ -0,0 +1,5 @@
+import { EditorMathExpression, EditorMathNode } from '../model.js';
+
+export declare function parseLinearMath(linear: string): EditorMathExpression;
+export declare function serializeLinearMathNodes(nodes: EditorMathNode[]): string;
+export declare function serializeLinearMath(expression: EditorMathExpression): string;

package/dist/core/model/index.d.ts

@@ -9,8 +9,10 @@
 export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorLineDash, EditorImageBorder, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, EditorGradientStop, EditorTextFill, EditorTextOutline, EditorTextShadow, EditorGlow, EditorReflection, } from './types/primitives.js';
 export type { EditorTextStyle, EditorParagraphStyle, EditorTableStyle, EditorTableFloatingLayout, EditorTableConditionalFormat, EditorConditionalRowStyle, EditorTableConditionalType, EditorTableConditionalFlags, EditorTableCellStyle, EditorNamedStyle, } from './types/styles.js';
 export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorSdtBlockWrapper, EditorSdtPr, EditorSdtSubtype, EditorSdtListItem, EditorSdtDataBinding, EditorParagraphNode, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
+export type { EditorMathNode, EditorMathText, EditorMathFraction, EditorMathRadical, EditorMathScript, EditorMathDelimiter, EditorMathAccent, EditorMathNary, EditorMathLimit, EditorMathMatrix, EditorMathBox, EditorMathGroup, EditorMathRaw, EditorMathStyle, EditorMathExpression, } from './types/math.js';
+export { EMPTY_EDITOR_MATH_EXPRESSION, MATH_OBJECT_REPLACEMENT, } from './types/math.js';
 export type { RunKind, RunOfKind, RunVisitor } from './runKind.js';
-export { getRunKind, isInlineObjectRun, visitRun, getRunImage, getRunTextBox, getRunField, getRunFieldChar, getRunFieldInstruction, getRunFootnoteReference, getRunEndnoteReference, getRunSym, } from './runKind.js';
+export { getRunKind, isInlineObjectRun, visitRun, getRunImage, getRunTextBox, getRunField, getRunFieldChar, getRunFieldInstruction, getRunFootnoteReference, getRunEndnoteReference, getRunSym, getRunMath, } from './runKind.js';
 export type { EditorFootnote } from './types/documentFootnotes.js';
 export type { EditorEndnote } from './types/documentEndnotes.js';
 export type { EditorBookmark, EditorBookmarkAnchor, EditorBookmarks, } from './types/documentBookmarks.js';

package/dist/core/model/runKind.d.ts

@@ -1,4 +1,5 @@
 import { EditorTextBoxData, EditorTextRun } from './types/nodes.js';
+import { EditorMathExpression } from './types/math.js';
 import { EditorFieldChar, EditorFieldData, EditorImageRunData, EditorFootnoteReferenceData, EditorEndnoteReferenceData } from './types/primitives.js';
 
 /**
@@ -26,6 +27,7 @@ export declare function getRunSym(run: EditorTextRun): {
     font: string;
     char: string;
 } | undefined;
+export declare function getRunMath(run: EditorTextRun): EditorMathExpression | undefined;
 export interface RunVisitor<R> {
     text(run: RunOfKind<"text">): R;
     image(run: RunOfKind<"image">): R;
@@ -36,6 +38,7 @@ export interface RunVisitor<R> {
     footnoteReference(run: RunOfKind<"footnoteReference">): R;
     endnoteReference(run: RunOfKind<"endnoteReference">): R;
     sym(run: RunOfKind<"sym">): R;
+    math?(run: RunOfKind<"math">): R;
 }
 /**
  * Exhaustive dispatch over a run's kind, narrowing the run to the matching union

package/dist/core/model/types/layout.d.ts

@@ -1,4 +1,5 @@
 import { EditorBlockNode, EditorTextBoxData } from './nodes.js';
+import { EditorMathExpression } from './math.js';
 import { EditorPageSettings } from './document.js';
 import { EditorRevision, EditorImageRunData } from './primitives.js';
 import { EditorTextStyle } from './styles.js';
@@ -24,6 +25,7 @@ export interface EditorLayoutFragment {
     styles?: EditorTextStyle;
     image?: EditorImageRunData;
     textBox?: EditorTextBoxData;
+    math?: EditorMathExpression;
     revision?: EditorRevision;
     chars: EditorLayoutFragmentChar[];
 }

package/dist/core/model/types/math.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Structured Office Math Markup Language (OMML) data used by the editor.
+ *
+ * Math expressions are deliberately independent from the document tree.  A
+ * paragraph stores one expression as an inline object; the expression itself
+ * is edited as this small, serialisable AST.
+ */
+export type EditorMathNode = EditorMathText | EditorMathFraction | EditorMathRadical | EditorMathScript | EditorMathDelimiter | EditorMathAccent | EditorMathNary | EditorMathLimit | EditorMathMatrix | EditorMathBox | EditorMathGroup | EditorMathRaw;
+export interface EditorMathText {
+    kind: "text";
+    value: string;
+    style?: EditorMathStyle;
+}
+export interface EditorMathFraction {
+    kind: "fraction";
+    numerator: EditorMathNode[];
+    denominator: EditorMathNode[];
+    bar?: boolean;
+}
+export interface EditorMathRadical {
+    kind: "radical";
+    radicand: EditorMathNode[];
+    degree?: EditorMathNode[];
+}
+export interface EditorMathScript {
+    kind: "script";
+    base: EditorMathNode[];
+    subscript?: EditorMathNode[];
+    superscript?: EditorMathNode[];
+}
+export interface EditorMathDelimiter {
+    kind: "delimiter";
+    children: EditorMathNode[][];
+    begin?: string;
+    end?: string;
+    separator?: string;
+    grow?: boolean;
+}
+export interface EditorMathAccent {
+    kind: "accent";
+    accent: string;
+    children: EditorMathNode[];
+}
+export interface EditorMathNary {
+    kind: "nary";
+    operator: string;
+    children: EditorMathNode[];
+    subscript?: EditorMathNode[];
+    superscript?: EditorMathNode[];
+    grow?: boolean;
+}
+export interface EditorMathLimit {
+    kind: "limit";
+    operator: "low" | "upper";
+    base: EditorMathNode[];
+    limit: EditorMathNode[];
+}
+export interface EditorMathMatrix {
+    kind: "matrix";
+    rows: EditorMathNode[][][];
+    rowGap?: number;
+    columnGap?: number;
+}
+export interface EditorMathBox {
+    kind: "box";
+    children: EditorMathNode[];
+    border?: boolean;
+    hidden?: boolean;
+}
+export interface EditorMathGroup {
+    kind: "group";
+    children: EditorMathNode[];
+}
+/** Unknown OMML is retained so importing and re-exporting remains lossless. */
+export interface EditorMathRaw {
+    kind: "raw";
+    xml: string;
+    fallbackText?: string;
+}
+export interface EditorMathStyle {
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    normalText?: boolean;
+    script?: "roman" | "script" | "fraktur" | "double-struck";
+}
+export interface EditorMathExpression {
+    version: 1;
+    children: EditorMathNode[];
+    display?: boolean;
+    /** Original OMML for diagnostics and exact round-trip of untouched data. */
+    sourceXml?: string;
+}
+export declare const EMPTY_EDITOR_MATH_EXPRESSION: EditorMathExpression;
+export declare const MATH_OBJECT_REPLACEMENT = "\uFFFC";

package/dist/core/model/types/nodes.d.ts

@@ -1,4 +1,5 @@
 import { EditorDocxWidthValue, EditorEndnoteReferenceData, EditorFieldChar, EditorFieldData, EditorFootnoteReferenceData, EditorImageFloatingLayout, EditorImageRunData, EditorParagraphListStyle, EditorRevision, EditorPropertyRevision, EditorStructuralRevision, EditorTableRowHeightRule } from './primitives.js';
+import { EditorMathExpression } from './math.js';
 import { EditorParagraphStyle, EditorTableCellStyle, EditorTableStyle, EditorTableConditionalFlags, EditorTextStyle } from './styles.js';
 
 /**
@@ -127,6 +128,9 @@ export type EditorTextRun = (EditorRunBase & {
         font: string;
         char: string;
     };
+}) | (EditorRunBase & {
+    kind: "math";
+    math: EditorMathExpression;
 });
 /**
  * A drop cap (Word's `w:framePr/@dropCap`): a large initial letter sunk into

package/dist/export/docx/text/mathXml.d.ts

@@ -0,0 +1,3 @@
+import { EditorMathExpression } from '../../../core/model.js';
+
+export declare function serializeMathExpression(expression: EditorMathExpression): string;

package/dist/i18n/locales/en.d.ts

@@ -2,10 +2,13 @@ export declare const en: {
     "toolbar.file": string;
     "toolbar.export": string;
     "toolbar.import": string;
+    "toolbar.newDocument": string;
+    "toolbar.importDocx": string;
     "toolbar.undo": string;
     "toolbar.redo": string;
     "toolbar.insert": string;
     "toolbar.image": string;
+    "toolbar.symbols": string;
     "toolbar.imageCaption": string;
     "toolbar.shapes": string;
     "toolbar.shape.rect": string;
@@ -63,6 +66,17 @@ export declare const en: {
     "toolbar.formatUpperRoman": string;
     "toolbar.formatBullet": string;
     "toolbar.moreTools": string;
+    "symbols.menu.equation": string;
+    "symbols.menu.symbol": string;
+    "symbols.menu.number": string;
+    "symbols.more": string;
+    "symbols.category.all": string;
+    "symbols.category.common": string;
+    "symbols.category.math": string;
+    "symbols.category.arrows": string;
+    "symbols.category.currency": string;
+    "symbols.category.greek": string;
+    "symbols.category.numbers": string;
     "toolbar.style": string;
     "toolbar.fontFamily": string;
     "toolbar.font": string;
@@ -324,10 +338,27 @@ export declare const en: {
     "layoutOptions.fixPosition": string;
     "layoutOptions.behindHint": string;
     "generic.close": string;
+    "generic.back": string;
     "generic.cancel": string;
     "generic.save": string;
     "generic.apply": string;
     "generic.ok": string;
+    "dialog.symbol.title": string;
+    "dialog.symbol.insert": string;
+    "dialog.symbol.font": string;
+    "dialog.symbol.subset": string;
+    "dialog.symbol.preview": string;
+    "dialog.symbol.recent": string;
+    "dialog.symbol.code": string;
+    "dialog.symbol.doubleClickHelp": string;
+    "dialog.equation.title": string;
+    "dialog.equation.insert": string;
+    "dialog.equation.structures": string;
+    "dialog.equation.linear": string;
+    "dialog.equation.empty": string;
+    "dialog.newDocument.title": string;
+    "dialog.newDocument.message": string;
+    "dialog.newDocument.discard": string;
     "title.untitled": string;
     "dialog.imageAlt.title": string;
     "dialog.imageAlt.label": string;

package/dist/i18n/locales/pt-BR.d.ts

@@ -2,10 +2,13 @@ export declare const ptBR: {
     "toolbar.file": string;
     "toolbar.export": string;
     "toolbar.import": string;
+    "toolbar.newDocument": string;
+    "toolbar.importDocx": string;
     "toolbar.undo": string;
     "toolbar.redo": string;
     "toolbar.insert": string;
     "toolbar.image": string;
+    "toolbar.symbols": string;
     "toolbar.imageCaption": string;
     "toolbar.shapes": string;
     "toolbar.shape.rect": string;
@@ -63,6 +66,17 @@ export declare const ptBR: {
     "toolbar.formatUpperRoman": string;
     "toolbar.formatBullet": string;
     "toolbar.moreTools": string;
+    "symbols.menu.equation": string;
+    "symbols.menu.symbol": string;
+    "symbols.menu.number": string;
+    "symbols.more": string;
+    "symbols.category.all": string;
+    "symbols.category.common": string;
+    "symbols.category.math": string;
+    "symbols.category.arrows": string;
+    "symbols.category.currency": string;
+    "symbols.category.greek": string;
+    "symbols.category.numbers": string;
     "toolbar.style": string;
     "toolbar.fontFamily": string;
     "toolbar.font": string;
@@ -324,10 +338,27 @@ export declare const ptBR: {
     "layoutOptions.fixPosition": string;
     "layoutOptions.behindHint": string;
     "generic.close": string;
+    "generic.back": string;
     "generic.cancel": string;
     "generic.save": string;
     "generic.apply": string;
     "generic.ok": string;
+    "dialog.symbol.title": string;
+    "dialog.symbol.insert": string;
+    "dialog.symbol.font": string;
+    "dialog.symbol.subset": string;
+    "dialog.symbol.preview": string;
+    "dialog.symbol.recent": string;
+    "dialog.symbol.code": string;
+    "dialog.symbol.doubleClickHelp": string;
+    "dialog.equation.title": string;
+    "dialog.equation.insert": string;
+    "dialog.equation.structures": string;
+    "dialog.equation.linear": string;
+    "dialog.equation.empty": string;
+    "dialog.newDocument.title": string;
+    "dialog.newDocument.message": string;
+    "dialog.newDocument.discard": string;
     "title.untitled": string;
     "dialog.imageAlt.title": string;
     "dialog.imageAlt.label": string;

package/dist/import/docx/math.d.ts

@@ -0,0 +1,5 @@
+import { Element as XmlElement } from '@xmldom/xmldom';
+import { EditorMathExpression } from '../../core/model.js';
+
+export declare const MATH_NS = "http://schemas.openxmlformats.org/officeDocument/2006/math";
+export declare function parseMathExpression(element: XmlElement): EditorMathExpression;

package/dist/import/docx/runs/types.d.ts

@@ -1,5 +1,5 @@
 import { Element as XmlElement } from '@xmldom/xmldom';
-import { EditorBlockNode, EditorTextStyle, EditorImageRunData, EditorTextBoxData } from '../../../core/model.js';
+import { EditorBlockNode, EditorTextStyle, EditorImageRunData, EditorTextBoxData, EditorMathExpression } from '../../../core/model.js';
 
 export type ParseNestedBlocks = (container: XmlElement) => Promise<EditorBlockNode[]>;
 /**
@@ -53,4 +53,5 @@ export interface ImportedRun {
         font: string;
         char: string;
     };
+    math?: EditorMathExpression;
 }