@drghaliasri/butex 5.5.2 → 5.5.4

package/dist/react-document2.d.mts

@@ -5,7 +5,7 @@ type EditorNodeKind = 'char' | 'number' | 'operator' | 'delimiter' | 'frac' | 's
 type MatrixEnvStyle = 'matrix' | 'pmatrix' | 'bmatrix' | 'Bmatrix' | 'vmatrix' | 'Vmatrix';
 type GridEnvName = MatrixEnvStyle | 'array' | 'aligned';
 type EnvColumnAlignment = 'l' | 'c' | 'r';
-type CharacterFontId = 'default' | 'takween' | 'diwani' | 'diwaniOutline';
+type CharacterFontId = 'default' | 'takween' | 'diwani' | 'diwaniOutline' | 'maghribi';
 type DigitFormId = 'western' | 'arabicIndic' | 'persianIndic';
 type EditorSyncState = 'synced' | 'diverged';
 type EditorChain = {
@@ -143,7 +143,20 @@ type MathObject2Json = {
     math_mode: string;
     lines: ChainJson[];
     closing: string;
+    /** Side used by the delimited source stored in the containing value/cell. */
+    source_side?: Document2ParseMode;
+    /** Preserve whether LaTeX export should prefer imported AST rendering or editor source. */
+    source_owner?: 'imported-structured' | 'editor';
+    label_enabled?: boolean;
+    label?: string;
+};
+/** Positional metadata for a raw-only span that has no structured equation AST. */
+type RawMathObject2Json = {
+    node_type: 'RawMathObject';
+    label_enabled?: boolean;
+    label?: string;
 };
+type Document2MathObjectJson = MathObject2Json | RawMathObject2Json;
 type ReferenceFieldSeparator = ',' | '،';
 type Reference2Json = {
     key: string;
@@ -179,7 +192,7 @@ type Document2BlockJson = {
     formats?: TextFormatSpan2Json[];
     /** Stable host asset identity (e.g. S3 key / UUID); optional for \\includegraphics. */
     asset_id?: string;
-    math_objects?: MathObject2Json[];
+    math_objects?: Array<Document2MathObjectJson | null>;
     options?: Record<string, string>;
     closing?: string;
     items?: Document2ListItemJson[];
@@ -195,7 +208,7 @@ type Document2BlockJson = {
 type Document2ListItemJson = {
     value: string;
     formats?: TextFormatSpan2Json[];
-    math_objects?: MathObject2Json[];
+    math_objects?: Array<Document2MathObjectJson | null>;
     blocks?: Document2BlockJson[];
 };
 type Document2Diagnostic = {
@@ -463,6 +476,8 @@ type ButexDocumentEditor2Props = {
         value: string;
     }) => string;
     onDocumentChange?: (document: Document2Node) => void;
+    /** Canonical JSON wire format for API/database persistence. */
+    onDocumentJsonChange?: (document: Document2Json) => void;
     onLatexChange?: (latex: string) => void;
 };
 type Document2InitialState = {
@@ -470,7 +485,7 @@ type Document2InitialState = {
     error: string | null;
 };
 declare function resolveInitialDocument2(initialDocument: Document2Json | Document2Node | undefined, uiLocale?: ButexUiLocale, documentMeta?: Document2MetaProp): Document2InitialState;
-declare function ButexDocumentEditor2({ initialDocument, documentMeta, className, debug, documentDirection, equationSide, editableEquations, previewOnly, uiLocale, mathOutput, digitForm: digitFormProp, onDigitFormChange, resolveImageUrl, onDocumentChange, onLatexChange, }: ButexDocumentEditor2Props): react_jsx_runtime.JSX.Element;
+declare function ButexDocumentEditor2({ initialDocument, documentMeta, className, debug, documentDirection, equationSide, editableEquations, previewOnly, uiLocale, mathOutput, digitForm: digitFormProp, onDigitFormChange, resolveImageUrl, onDocumentChange, onDocumentJsonChange, onLatexChange, }: ButexDocumentEditor2Props): react_jsx_runtime.JSX.Element;
 
 type DocumentInsertToolbarProps = {
     canUndo: boolean;

package/dist/react-document2.d.ts

@@ -5,7 +5,7 @@ type EditorNodeKind = 'char' | 'number' | 'operator' | 'delimiter' | 'frac' | 's
 type MatrixEnvStyle = 'matrix' | 'pmatrix' | 'bmatrix' | 'Bmatrix' | 'vmatrix' | 'Vmatrix';
 type GridEnvName = MatrixEnvStyle | 'array' | 'aligned';
 type EnvColumnAlignment = 'l' | 'c' | 'r';
-type CharacterFontId = 'default' | 'takween' | 'diwani' | 'diwaniOutline';
+type CharacterFontId = 'default' | 'takween' | 'diwani' | 'diwaniOutline' | 'maghribi';
 type DigitFormId = 'western' | 'arabicIndic' | 'persianIndic';
 type EditorSyncState = 'synced' | 'diverged';
 type EditorChain = {
@@ -143,7 +143,20 @@ type MathObject2Json = {
     math_mode: string;
     lines: ChainJson[];
     closing: string;
+    /** Side used by the delimited source stored in the containing value/cell. */
+    source_side?: Document2ParseMode;
+    /** Preserve whether LaTeX export should prefer imported AST rendering or editor source. */
+    source_owner?: 'imported-structured' | 'editor';
+    label_enabled?: boolean;
+    label?: string;
+};
+/** Positional metadata for a raw-only span that has no structured equation AST. */
+type RawMathObject2Json = {
+    node_type: 'RawMathObject';
+    label_enabled?: boolean;
+    label?: string;
 };
+type Document2MathObjectJson = MathObject2Json | RawMathObject2Json;
 type ReferenceFieldSeparator = ',' | '،';
 type Reference2Json = {
     key: string;
@@ -179,7 +192,7 @@ type Document2BlockJson = {
     formats?: TextFormatSpan2Json[];
     /** Stable host asset identity (e.g. S3 key / UUID); optional for \\includegraphics. */
     asset_id?: string;
-    math_objects?: MathObject2Json[];
+    math_objects?: Array<Document2MathObjectJson | null>;
     options?: Record<string, string>;
     closing?: string;
     items?: Document2ListItemJson[];
@@ -195,7 +208,7 @@ type Document2BlockJson = {
 type Document2ListItemJson = {
     value: string;
     formats?: TextFormatSpan2Json[];
-    math_objects?: MathObject2Json[];
+    math_objects?: Array<Document2MathObjectJson | null>;
     blocks?: Document2BlockJson[];
 };
 type Document2Diagnostic = {
@@ -463,6 +476,8 @@ type ButexDocumentEditor2Props = {
         value: string;
     }) => string;
     onDocumentChange?: (document: Document2Node) => void;
+    /** Canonical JSON wire format for API/database persistence. */
+    onDocumentJsonChange?: (document: Document2Json) => void;
     onLatexChange?: (latex: string) => void;
 };
 type Document2InitialState = {
@@ -470,7 +485,7 @@ type Document2InitialState = {
     error: string | null;
 };
 declare function resolveInitialDocument2(initialDocument: Document2Json | Document2Node | undefined, uiLocale?: ButexUiLocale, documentMeta?: Document2MetaProp): Document2InitialState;
-declare function ButexDocumentEditor2({ initialDocument, documentMeta, className, debug, documentDirection, equationSide, editableEquations, previewOnly, uiLocale, mathOutput, digitForm: digitFormProp, onDigitFormChange, resolveImageUrl, onDocumentChange, onLatexChange, }: ButexDocumentEditor2Props): react_jsx_runtime.JSX.Element;
+declare function ButexDocumentEditor2({ initialDocument, documentMeta, className, debug, documentDirection, equationSide, editableEquations, previewOnly, uiLocale, mathOutput, digitForm: digitFormProp, onDigitFormChange, resolveImageUrl, onDocumentChange, onDocumentJsonChange, onLatexChange, }: ButexDocumentEditor2Props): react_jsx_runtime.JSX.Element;
 
 type DocumentInsertToolbarProps = {
     canUndo: boolean;