@drghaliasri/butex 5.4.6 → 5.5.0

package/README.md

@@ -253,7 +253,7 @@ const latex = document2Latex(documentNode);
 const preview = document2Preview(documentNode, 'svg');
 ```
 
-`document2Latex(doc)` emits a **complete Arabic XeLaTeX document** by default (preamble + `\begin{document}` + body + `\end{document}`). Pass `{ wrapDocument: false }` for body-only blocks. Optional `digitsMapping: 'arabicdigits' | 'digits'` controls eastern vs western digit font mapping in the preamble (default `'arabicdigits'`). Pass `{ twocolumn: true }` for `\documentclass[12pt,a4paper,notitlepage,twocolumn]{article}` (title block stays in-column; figures use `\columnwidth`). See [`examples/example-latex-export.tex`](examples/example-latex-export.tex) for a full sample (regenerated by the wrap vitest). Hosts can also call `getArabicXeLatexPreamble()` alone.
+`document2Latex(doc)` emits a **complete Arabic XeLaTeX document** by default (preamble + `\begin{document}` + body + `\end{document}`). Pass `{ wrapDocument: false }` for body-only blocks. Paragraph blocks export as `\par` followed by the inline content, so prose, citations, and math are not wrapped inside `\paragraph{...}`. Optional `digitsMapping: 'arabicdigits' | 'digits'` controls eastern vs western digit font mapping in the preamble (default `'arabicdigits'`). Pass `{ twocolumn: true }` for `\documentclass[12pt,a4paper,notitlepage,twocolumn]{article}` (title block stays in-column; figures use `\columnwidth`). See [`examples/example-latex-export.tex`](examples/example-latex-export.tex) for a full sample (regenerated by the wrap vitest). Hosts can also call `getArabicXeLatexPreamble()` alone.
 
 Figures and tables always export as centered `figure` / `table` floats. Optional caption/label fields (checkbox-driven in the editor) emit `\caption` / `\label`. Display math stays `\[…\]` unless an equation label is enabled, then export uses `\begin{equation}…\label{…}\end{equation}`. Internal cross-refs use `\ref` / `\eqref` tokens (separate from bibliography `\cite`).
 
@@ -343,7 +343,7 @@ Host apps still register BuTeX with MathJax before preview rendering. `uiLocale`
 - Core editor classes (`.surface`, `.chain`, `.slot`, `.node`, `.scripts`, `.delim*`, etc.) are shipped from `src/editor/styles.ts`.
 - Theme with **one namespace**, `--butex-*`, on `.butex-widget` (or an ancestor of the editor surface). Defaults are set on `ButexEditor`’s root; hosts override accents, borders, **`--butex-surface-bg` / `--butex-surface-fg`**, **`--butex-preview-bg` / `--butex-preview-fg`**, focus/slot/selection, scripts, optional **`--butex-dev-*`** / **`--butex-dev-inset-*`** when using `debug`, etc., without redefining structure classes.
 - Document editor theming is scoped under `.butex-document-widget`. Override `--butex-document-*` variables on that root or an ancestor, especially `--butex-document-bg`, `--butex-document-fg`, `--butex-document-panel`, `--butex-document-border`, `--butex-document-accent`, `--butex-document-preview-bg`, `--butex-document-drawer-bg`, `--butex-document-input-bg`, `--butex-document-table-border`, `--butex-document-math-bg`, and `--butex-document-dev-bg`.
-- Document editor v2 theming is scoped under `.butex-document2-widget`. Override `--butex-document2-*` variables on that root or an ancestor; defaults inherit from the existing `--butex-*` variables where practical, including accent, panel, border, preview, focus, danger/error, and debug colors. The embedded equation editor opens as a centered modal (backdrop + panel); its BuTeX chrome reads the same `--butex-document2-*` tokens via a scoped bridge, so hosts normally theme once on `.butex-document2-widget` without a second equation theme. The built-in editor uses a **sticky compact icon toolbar** (heading glyphs, inline `$…$` vs display `\[…\]` math buttons with tooltips, table size popover), **focus-aware block insertion** after the active block, **↑/↓ block reorder**, **math delete** (chip × and drawer button), **document undo/redo** (toolbar + Ctrl/⌘Z, Ctrl/⌘Shift+Z, Ctrl+Y) via AST snapshots, and theme-tinted block cards. Preview tables use fixed black cell borders; raw `\raw` blocks stay out of preview until dedicated rendering exists.
+- Document editor v2 theming is scoped under `.butex-document2-widget`. Override `--butex-document2-*` variables on that root or an ancestor; defaults inherit from the existing `--butex-*` variables where practical, including accent, panel, border, preview, focus, danger/error, and debug colors. The embedded equation editor opens as a centered modal (backdrop + panel); its BuTeX chrome reads the same `--butex-document2-*` tokens via a scoped bridge, so hosts normally theme once on `.butex-document2-widget` without a second equation theme. The built-in editor uses a **sticky compact icon toolbar** (Arabic `نص` formatting icons, heading glyphs, inline `$…$` vs display `\[…\]` math buttons with tooltips, a labeled references menu, and a table size popover), **focus-aware block insertion** after the active block, **↑/↓ block reorder**, **math delete** (chip × and drawer button), **document undo/redo** (toolbar + Ctrl/⌘Z, Ctrl/⌘Shift+Z, Ctrl+Y) via AST snapshots, and theme-tinted block cards. Preview tables use fixed black cell borders; raw `\raw` blocks stay out of preview until dedicated rendering exists.
 
 ## Demo
 

package/dist/document2.d.mts

@@ -175,6 +175,7 @@ type Document2Json = {
 type Document2BlockJson = {
     command: string;
     value?: string;
+    formats?: TextFormatSpan2Json[];
     /** Stable host asset identity (e.g. S3 key / UUID); optional for \\includegraphics. */
     asset_id?: string;
     math_objects?: MathObject2Json[];
@@ -182,6 +183,7 @@ type Document2BlockJson = {
     closing?: string;
     items?: Document2ListItemJson[];
     rows?: string[][];
+    cell_formats?: TextFormatSpan2Json[][][];
     columns?: string;
     caption?: string;
     label?: string;
@@ -191,6 +193,7 @@ type Document2BlockJson = {
 };
 type Document2ListItemJson = {
     value: string;
+    formats?: TextFormatSpan2Json[];
     math_objects?: MathObject2Json[];
     blocks?: Document2BlockJson[];
 };
@@ -210,10 +213,23 @@ type Reference2 = {
     /** Joins authors/title/venue/year in bibliography display and export. */
     fieldSeparator: ReferenceFieldSeparator;
 };
+type TextStyle2 = {
+    bold?: true;
+    italic?: true;
+    underline?: true;
+};
+type TextFormatSpan2Json = {
+    start: number;
+    end: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+};
 type TextToken2 = {
     id: string;
     kind: 'text';
     text: string;
+    style?: TextStyle2;
 };
 type MathToken2 = {
     id: string;
@@ -344,6 +360,7 @@ type DetectedInlineSpan2 = ({
 type PreviewInline2 = {
     kind: 'text';
     text: string;
+    style?: TextStyle2;
 } | {
     kind: 'math';
     id: string;
@@ -570,6 +587,7 @@ declare function insertDocument2BlockAfter(document: Document2Node, afterBlockId
 declare function moveDocument2BlockById(document: Document2Node, blockId: string, direction: -1 | 1): Document2Node;
 declare function moveDocument2BlockRange(document: Document2Node, from: number, to: number, direction: -1 | 1): Document2Node;
 declare function removeDocument2BlockRange(document: Document2Node, from: number, to: number): Document2Node;
+declare function toggleTextTokenStyle(document: Document2Node, fieldId: string, tokenId: string, selectionStart: number, selectionEnd: number, styleName: keyof TextStyle2): Document2Node;
 declare function removeMathTokenById(document: Document2Node, tokenId: string): Document2Node;
 declare function insertMathTokenAtCaret(document: Document2Node, fieldId: string, textTokenId: string | null, caretOffset: number, session: EditorSession, opening?: string, closing?: string, side?: EditorSide): Document2Node;
 declare function insertMathToken(document: Document2Node, fieldId: string, insertIndex: number, session: EditorSession, opening?: string, closing?: string, side?: EditorSide): Document2Node;
@@ -699,7 +717,7 @@ declare function toggleBlockInSelection(state: BlockSelectionState, index: numbe
 declare function extendBlockSelectionFromAnchor(state: BlockSelectionState, index: number, blockCount: number): BlockSelectionState;
 declare function remapSelectionAfterRangeMove(selection: BlockSelectionRange, direction: -1 | 1): BlockSelectionRange;
 
-declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[]): InlineField2;
+declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[], formats?: TextFormatSpan2Json[]): InlineField2;
 declare function fromDocumentJson2(json: unknown, options?: ImportDocument2Options): Document2Node;
 declare function createEmptyDocument2(): Document2Node;
 
@@ -732,4 +750,4 @@ type Document2PreviewOptions = {
 };
 declare function document2Preview(document: Document2Node, output?: Document2MathOutput, equationSide?: EditorSide, previewOptions?: Document2PreviewOptions): Document2Preview;
 
-export { type ArabicDigitsMapping, type ArabicXeLatexPreambleOptions, BUTEX_BASMALA, BUTEX_BASMALA_LINE1, BUTEX_BASMALA_LINE2, BUTEX_BASMALA_SALAWAT, BUTEX_CLOSING_HAMDALA, type BibliographyBlock2, type BlockSelectionRange, type BlockSelectionState, type CiteToken2, DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, DEFAULT_HIJRI_DATE, DEFAULT_REFERENCE_FIELD_SEPARATOR, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2Direction, type Document2HijriDate, type Document2HistoryStacks, type Document2Json, type Document2KeyError, type Document2KeyNamespace, type Document2LabelEntry, type Document2LabelKind, type Document2LatexOptions, type Document2MathOutput, type Document2Meta, type Document2MetaProp, type Document2Node, type Document2Preview, type Document2PreviewOptions, type FloatMeta2, type FloatMetaPatch, type FormatCiteLabelOptions, type FormatFloatCaptionTitleOptions, HIJRI_MONTH_IDS, HIJRI_YEAR_MAX, HIJRI_YEAR_MIN, type HijriMonthId, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type RefToken2, type Reference2, type Reference2Json, type ReferenceFieldSeparator, type TableBlock2, type TextBlock2, type TextToken2, absoluteHttpHref, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2Reference, addDocument2TableBlock, addDocument2TextBlock, applyFloatMetaPatch, arabicXeLatexPreambleCmd, arabicXeLatexPreambleFont, arabicXeLatexPreamblePkg, bibliographyEntryBody, bibliographyEntryLatex, butexBasmalaDisplayLatex, butexBasmalaDisplayTex, butexBasmalaTitlingPreamble, butexDiwaniDisplayLatex, butexDiwaniDisplayTex, butexInColumnMaketitleHook, citeTokenLatex, cloneDocument2Meta, cloneDocument2Node, collectDocument2Labels, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createEmptyEquationSession, createEmptyReference2, createInlineField2, defaultFloatMeta, detectInlineSpans2, detectMathSpans2, document2HasAbstract, document2HasMaketitle, document2HasTitleStack, document2HistoryCanRedo, document2HistoryCanUndo, document2KeyError, document2Latex, document2Preview, emptyBlockSelection, emptyDocument2Meta, ensureDocument2BibliographyBlock, extendBlockSelectionFromAnchor, fillDocument2MetaGaps, findFirstInlineField, formatBibliographyNumber, formatCiteLabel, formatFloatCaptionPreview, formatFloatCaptionTitle, formatHijriDate, formatRefLabel, fromDocumentJson2, getArabicXeLatexPreamble, hijriMonthLabel, inlineFieldLatex, insertCiteTokenAtCaret, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, insertRefTokenAtCaret, isDuplicateDocument2Key, isValidDocument2Key, labelNumberMap, mathNodeFromArabicSession, mathNodeFromSession, mathSourceFromArabicSession, mathSourceFromSession, mathTokenSourceForSide, mathTokenToArabicEditorSession, mathTokenToEditorSession, mergeDocument2Meta, moveDocument2BlockById, moveDocument2BlockRange, moveDocument2Reference, normalizeBlockSelection, normalizeDocument2HijriDate, normalizeDocument2Key, normalizeDocument2Meta, normalizeReferenceFieldSeparator, parseCiteKeys, parseFloatMetaFromJson, parseRefKeys, pushDocument2Snapshot, refTokenLatex, referenceFromJson, referenceNumberMap, remapSelectionAfterRangeMove, removeCiteTokenById, removeDocument2BlockById, removeDocument2BlockRange, removeDocument2ListItem, removeDocument2Reference, removeMathTokenById, removeRefTokenById, replaceMathTokenFromSession, resolveCiteNumbers, restoreDocument2Redo, restoreDocument2Undo, setDocument2References, stripDisplayMathDelimiters, toggleBlockInSelection, updateCiteTokenKeys, updateDocument2ImageMeta, updateDocument2ImageValue, updateDocument2Meta, updateDocument2Reference, updateDocument2TableMeta, updateDocument2TextBlockCentered, updateMathTokenLabel, updateRefTokenKeys, updateTextToken };
+export { type ArabicDigitsMapping, type ArabicXeLatexPreambleOptions, BUTEX_BASMALA, BUTEX_BASMALA_LINE1, BUTEX_BASMALA_LINE2, BUTEX_BASMALA_SALAWAT, BUTEX_CLOSING_HAMDALA, type BibliographyBlock2, type BlockSelectionRange, type BlockSelectionState, type CiteToken2, DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, DEFAULT_HIJRI_DATE, DEFAULT_REFERENCE_FIELD_SEPARATOR, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2Direction, type Document2HijriDate, type Document2HistoryStacks, type Document2Json, type Document2KeyError, type Document2KeyNamespace, type Document2LabelEntry, type Document2LabelKind, type Document2LatexOptions, type Document2MathOutput, type Document2Meta, type Document2MetaProp, type Document2Node, type Document2Preview, type Document2PreviewOptions, type FloatMeta2, type FloatMetaPatch, type FormatCiteLabelOptions, type FormatFloatCaptionTitleOptions, HIJRI_MONTH_IDS, HIJRI_YEAR_MAX, HIJRI_YEAR_MIN, type HijriMonthId, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type RefToken2, type Reference2, type Reference2Json, type ReferenceFieldSeparator, type TableBlock2, type TextBlock2, type TextFormatSpan2Json, type TextStyle2, type TextToken2, absoluteHttpHref, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2Reference, addDocument2TableBlock, addDocument2TextBlock, applyFloatMetaPatch, arabicXeLatexPreambleCmd, arabicXeLatexPreambleFont, arabicXeLatexPreamblePkg, bibliographyEntryBody, bibliographyEntryLatex, butexBasmalaDisplayLatex, butexBasmalaDisplayTex, butexBasmalaTitlingPreamble, butexDiwaniDisplayLatex, butexDiwaniDisplayTex, butexInColumnMaketitleHook, citeTokenLatex, cloneDocument2Meta, cloneDocument2Node, collectDocument2Labels, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createEmptyEquationSession, createEmptyReference2, createInlineField2, defaultFloatMeta, detectInlineSpans2, detectMathSpans2, document2HasAbstract, document2HasMaketitle, document2HasTitleStack, document2HistoryCanRedo, document2HistoryCanUndo, document2KeyError, document2Latex, document2Preview, emptyBlockSelection, emptyDocument2Meta, ensureDocument2BibliographyBlock, extendBlockSelectionFromAnchor, fillDocument2MetaGaps, findFirstInlineField, formatBibliographyNumber, formatCiteLabel, formatFloatCaptionPreview, formatFloatCaptionTitle, formatHijriDate, formatRefLabel, fromDocumentJson2, getArabicXeLatexPreamble, hijriMonthLabel, inlineFieldLatex, insertCiteTokenAtCaret, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, insertRefTokenAtCaret, isDuplicateDocument2Key, isValidDocument2Key, labelNumberMap, mathNodeFromArabicSession, mathNodeFromSession, mathSourceFromArabicSession, mathSourceFromSession, mathTokenSourceForSide, mathTokenToArabicEditorSession, mathTokenToEditorSession, mergeDocument2Meta, moveDocument2BlockById, moveDocument2BlockRange, moveDocument2Reference, normalizeBlockSelection, normalizeDocument2HijriDate, normalizeDocument2Key, normalizeDocument2Meta, normalizeReferenceFieldSeparator, parseCiteKeys, parseFloatMetaFromJson, parseRefKeys, pushDocument2Snapshot, refTokenLatex, referenceFromJson, referenceNumberMap, remapSelectionAfterRangeMove, removeCiteTokenById, removeDocument2BlockById, removeDocument2BlockRange, removeDocument2ListItem, removeDocument2Reference, removeMathTokenById, removeRefTokenById, replaceMathTokenFromSession, resolveCiteNumbers, restoreDocument2Redo, restoreDocument2Undo, setDocument2References, stripDisplayMathDelimiters, toggleBlockInSelection, toggleTextTokenStyle, updateCiteTokenKeys, updateDocument2ImageMeta, updateDocument2ImageValue, updateDocument2Meta, updateDocument2Reference, updateDocument2TableMeta, updateDocument2TextBlockCentered, updateMathTokenLabel, updateRefTokenKeys, updateTextToken };

package/dist/document2.d.ts

@@ -175,6 +175,7 @@ type Document2Json = {
 type Document2BlockJson = {
     command: string;
     value?: string;
+    formats?: TextFormatSpan2Json[];
     /** Stable host asset identity (e.g. S3 key / UUID); optional for \\includegraphics. */
     asset_id?: string;
     math_objects?: MathObject2Json[];
@@ -182,6 +183,7 @@ type Document2BlockJson = {
     closing?: string;
     items?: Document2ListItemJson[];
     rows?: string[][];
+    cell_formats?: TextFormatSpan2Json[][][];
     columns?: string;
     caption?: string;
     label?: string;
@@ -191,6 +193,7 @@ type Document2BlockJson = {
 };
 type Document2ListItemJson = {
     value: string;
+    formats?: TextFormatSpan2Json[];
     math_objects?: MathObject2Json[];
     blocks?: Document2BlockJson[];
 };
@@ -210,10 +213,23 @@ type Reference2 = {
     /** Joins authors/title/venue/year in bibliography display and export. */
     fieldSeparator: ReferenceFieldSeparator;
 };
+type TextStyle2 = {
+    bold?: true;
+    italic?: true;
+    underline?: true;
+};
+type TextFormatSpan2Json = {
+    start: number;
+    end: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+};
 type TextToken2 = {
     id: string;
     kind: 'text';
     text: string;
+    style?: TextStyle2;
 };
 type MathToken2 = {
     id: string;
@@ -344,6 +360,7 @@ type DetectedInlineSpan2 = ({
 type PreviewInline2 = {
     kind: 'text';
     text: string;
+    style?: TextStyle2;
 } | {
     kind: 'math';
     id: string;
@@ -570,6 +587,7 @@ declare function insertDocument2BlockAfter(document: Document2Node, afterBlockId
 declare function moveDocument2BlockById(document: Document2Node, blockId: string, direction: -1 | 1): Document2Node;
 declare function moveDocument2BlockRange(document: Document2Node, from: number, to: number, direction: -1 | 1): Document2Node;
 declare function removeDocument2BlockRange(document: Document2Node, from: number, to: number): Document2Node;
+declare function toggleTextTokenStyle(document: Document2Node, fieldId: string, tokenId: string, selectionStart: number, selectionEnd: number, styleName: keyof TextStyle2): Document2Node;
 declare function removeMathTokenById(document: Document2Node, tokenId: string): Document2Node;
 declare function insertMathTokenAtCaret(document: Document2Node, fieldId: string, textTokenId: string | null, caretOffset: number, session: EditorSession, opening?: string, closing?: string, side?: EditorSide): Document2Node;
 declare function insertMathToken(document: Document2Node, fieldId: string, insertIndex: number, session: EditorSession, opening?: string, closing?: string, side?: EditorSide): Document2Node;
@@ -699,7 +717,7 @@ declare function toggleBlockInSelection(state: BlockSelectionState, index: numbe
 declare function extendBlockSelectionFromAnchor(state: BlockSelectionState, index: number, blockCount: number): BlockSelectionState;
 declare function remapSelectionAfterRangeMove(selection: BlockSelectionRange, direction: -1 | 1): BlockSelectionRange;
 
-declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[]): InlineField2;
+declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[], formats?: TextFormatSpan2Json[]): InlineField2;
 declare function fromDocumentJson2(json: unknown, options?: ImportDocument2Options): Document2Node;
 declare function createEmptyDocument2(): Document2Node;
 
@@ -732,4 +750,4 @@ type Document2PreviewOptions = {
 };
 declare function document2Preview(document: Document2Node, output?: Document2MathOutput, equationSide?: EditorSide, previewOptions?: Document2PreviewOptions): Document2Preview;
 
-export { type ArabicDigitsMapping, type ArabicXeLatexPreambleOptions, BUTEX_BASMALA, BUTEX_BASMALA_LINE1, BUTEX_BASMALA_LINE2, BUTEX_BASMALA_SALAWAT, BUTEX_CLOSING_HAMDALA, type BibliographyBlock2, type BlockSelectionRange, type BlockSelectionState, type CiteToken2, DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, DEFAULT_HIJRI_DATE, DEFAULT_REFERENCE_FIELD_SEPARATOR, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2Direction, type Document2HijriDate, type Document2HistoryStacks, type Document2Json, type Document2KeyError, type Document2KeyNamespace, type Document2LabelEntry, type Document2LabelKind, type Document2LatexOptions, type Document2MathOutput, type Document2Meta, type Document2MetaProp, type Document2Node, type Document2Preview, type Document2PreviewOptions, type FloatMeta2, type FloatMetaPatch, type FormatCiteLabelOptions, type FormatFloatCaptionTitleOptions, HIJRI_MONTH_IDS, HIJRI_YEAR_MAX, HIJRI_YEAR_MIN, type HijriMonthId, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type RefToken2, type Reference2, type Reference2Json, type ReferenceFieldSeparator, type TableBlock2, type TextBlock2, type TextToken2, absoluteHttpHref, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2Reference, addDocument2TableBlock, addDocument2TextBlock, applyFloatMetaPatch, arabicXeLatexPreambleCmd, arabicXeLatexPreambleFont, arabicXeLatexPreamblePkg, bibliographyEntryBody, bibliographyEntryLatex, butexBasmalaDisplayLatex, butexBasmalaDisplayTex, butexBasmalaTitlingPreamble, butexDiwaniDisplayLatex, butexDiwaniDisplayTex, butexInColumnMaketitleHook, citeTokenLatex, cloneDocument2Meta, cloneDocument2Node, collectDocument2Labels, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createEmptyEquationSession, createEmptyReference2, createInlineField2, defaultFloatMeta, detectInlineSpans2, detectMathSpans2, document2HasAbstract, document2HasMaketitle, document2HasTitleStack, document2HistoryCanRedo, document2HistoryCanUndo, document2KeyError, document2Latex, document2Preview, emptyBlockSelection, emptyDocument2Meta, ensureDocument2BibliographyBlock, extendBlockSelectionFromAnchor, fillDocument2MetaGaps, findFirstInlineField, formatBibliographyNumber, formatCiteLabel, formatFloatCaptionPreview, formatFloatCaptionTitle, formatHijriDate, formatRefLabel, fromDocumentJson2, getArabicXeLatexPreamble, hijriMonthLabel, inlineFieldLatex, insertCiteTokenAtCaret, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, insertRefTokenAtCaret, isDuplicateDocument2Key, isValidDocument2Key, labelNumberMap, mathNodeFromArabicSession, mathNodeFromSession, mathSourceFromArabicSession, mathSourceFromSession, mathTokenSourceForSide, mathTokenToArabicEditorSession, mathTokenToEditorSession, mergeDocument2Meta, moveDocument2BlockById, moveDocument2BlockRange, moveDocument2Reference, normalizeBlockSelection, normalizeDocument2HijriDate, normalizeDocument2Key, normalizeDocument2Meta, normalizeReferenceFieldSeparator, parseCiteKeys, parseFloatMetaFromJson, parseRefKeys, pushDocument2Snapshot, refTokenLatex, referenceFromJson, referenceNumberMap, remapSelectionAfterRangeMove, removeCiteTokenById, removeDocument2BlockById, removeDocument2BlockRange, removeDocument2ListItem, removeDocument2Reference, removeMathTokenById, removeRefTokenById, replaceMathTokenFromSession, resolveCiteNumbers, restoreDocument2Redo, restoreDocument2Undo, setDocument2References, stripDisplayMathDelimiters, toggleBlockInSelection, updateCiteTokenKeys, updateDocument2ImageMeta, updateDocument2ImageValue, updateDocument2Meta, updateDocument2Reference, updateDocument2TableMeta, updateDocument2TextBlockCentered, updateMathTokenLabel, updateRefTokenKeys, updateTextToken };
+export { type ArabicDigitsMapping, type ArabicXeLatexPreambleOptions, BUTEX_BASMALA, BUTEX_BASMALA_LINE1, BUTEX_BASMALA_LINE2, BUTEX_BASMALA_SALAWAT, BUTEX_CLOSING_HAMDALA, type BibliographyBlock2, type BlockSelectionRange, type BlockSelectionState, type CiteToken2, DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, DEFAULT_HIJRI_DATE, DEFAULT_REFERENCE_FIELD_SEPARATOR, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2Direction, type Document2HijriDate, type Document2HistoryStacks, type Document2Json, type Document2KeyError, type Document2KeyNamespace, type Document2LabelEntry, type Document2LabelKind, type Document2LatexOptions, type Document2MathOutput, type Document2Meta, type Document2MetaProp, type Document2Node, type Document2Preview, type Document2PreviewOptions, type FloatMeta2, type FloatMetaPatch, type FormatCiteLabelOptions, type FormatFloatCaptionTitleOptions, HIJRI_MONTH_IDS, HIJRI_YEAR_MAX, HIJRI_YEAR_MIN, type HijriMonthId, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type RefToken2, type Reference2, type Reference2Json, type ReferenceFieldSeparator, type TableBlock2, type TextBlock2, type TextFormatSpan2Json, type TextStyle2, type TextToken2, absoluteHttpHref, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2Reference, addDocument2TableBlock, addDocument2TextBlock, applyFloatMetaPatch, arabicXeLatexPreambleCmd, arabicXeLatexPreambleFont, arabicXeLatexPreamblePkg, bibliographyEntryBody, bibliographyEntryLatex, butexBasmalaDisplayLatex, butexBasmalaDisplayTex, butexBasmalaTitlingPreamble, butexDiwaniDisplayLatex, butexDiwaniDisplayTex, butexInColumnMaketitleHook, citeTokenLatex, cloneDocument2Meta, cloneDocument2Node, collectDocument2Labels, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createEmptyEquationSession, createEmptyReference2, createInlineField2, defaultFloatMeta, detectInlineSpans2, detectMathSpans2, document2HasAbstract, document2HasMaketitle, document2HasTitleStack, document2HistoryCanRedo, document2HistoryCanUndo, document2KeyError, document2Latex, document2Preview, emptyBlockSelection, emptyDocument2Meta, ensureDocument2BibliographyBlock, extendBlockSelectionFromAnchor, fillDocument2MetaGaps, findFirstInlineField, formatBibliographyNumber, formatCiteLabel, formatFloatCaptionPreview, formatFloatCaptionTitle, formatHijriDate, formatRefLabel, fromDocumentJson2, getArabicXeLatexPreamble, hijriMonthLabel, inlineFieldLatex, insertCiteTokenAtCaret, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, insertRefTokenAtCaret, isDuplicateDocument2Key, isValidDocument2Key, labelNumberMap, mathNodeFromArabicSession, mathNodeFromSession, mathSourceFromArabicSession, mathSourceFromSession, mathTokenSourceForSide, mathTokenToArabicEditorSession, mathTokenToEditorSession, mergeDocument2Meta, moveDocument2BlockById, moveDocument2BlockRange, moveDocument2Reference, normalizeBlockSelection, normalizeDocument2HijriDate, normalizeDocument2Key, normalizeDocument2Meta, normalizeReferenceFieldSeparator, parseCiteKeys, parseFloatMetaFromJson, parseRefKeys, pushDocument2Snapshot, refTokenLatex, referenceFromJson, referenceNumberMap, remapSelectionAfterRangeMove, removeCiteTokenById, removeDocument2BlockById, removeDocument2BlockRange, removeDocument2ListItem, removeDocument2Reference, removeMathTokenById, removeRefTokenById, replaceMathTokenFromSession, resolveCiteNumbers, restoreDocument2Redo, restoreDocument2Undo, setDocument2References, stripDisplayMathDelimiters, toggleBlockInSelection, toggleTextTokenStyle, updateCiteTokenKeys, updateDocument2ImageMeta, updateDocument2ImageValue, updateDocument2Meta, updateDocument2Reference, updateDocument2TableMeta, updateDocument2TextBlockCentered, updateMathTokenLabel, updateRefTokenKeys, updateTextToken };

package/dist/document2.js

@@ -133,6 +133,7 @@ __export(document2_exports, {
   setDocument2References: () => setDocument2References,
   stripDisplayMathDelimiters: () => stripDisplayMathDelimiters,
   toggleBlockInSelection: () => toggleBlockInSelection,
+  toggleTextTokenStyle: () => toggleTextTokenStyle,
   updateCiteTokenKeys: () => updateCiteTokenKeys,
   updateDocument2ImageMeta: () => updateDocument2ImageMeta,
   updateDocument2ImageValue: () => updateDocument2ImageValue,
@@ -1281,7 +1282,7 @@ function parseReferences(json) {
   }
   return references;
 }
-function createInlineField2(value = "", mathObjects = [], options = {}, path = "$", diagnostics = []) {
+function createInlineField2(value = "", mathObjects = [], options = {}, path = "$", diagnostics = [], formats = []) {
   const mode = options.mode ?? "english";
   const spans = detectInlineSpans2(value);
   const mathSpans = spans.filter((span) => span.kind === "math");
@@ -1293,7 +1294,7 @@ function createInlineField2(value = "", mathObjects = [], options = {}, path = "
   }
   for (const span of spans) {
     if (span.start > index) {
-      tokens.push({ id: document2Id("text"), kind: "text", text: value.slice(index, span.start) });
+      pushFormattedTextTokens(tokens, value.slice(index, span.start), index, formats);
     }
     if (span.kind === "cite") {
       tokens.push({
@@ -1349,9 +1350,81 @@ function createInlineField2(value = "", mathObjects = [], options = {}, path = "
     index = span.end;
   }
   if (index < value.length || tokens.length === 0) {
-    tokens.push({ id: document2Id("text"), kind: "text", text: value.slice(index) });
+    pushFormattedTextTokens(tokens, value.slice(index), index, formats);
+  }
+  return { id: document2Id("field"), tokens: compactTextTokens(tokens) };
+}
+function styleFromFormat(format) {
+  const style = {};
+  if (format.bold === true) {
+    style.bold = true;
+  }
+  if (format.italic === true) {
+    style.italic = true;
+  }
+  if (format.underline === true) {
+    style.underline = true;
+  }
+  return style.bold || style.italic || style.underline ? style : null;
+}
+function mergeTextStyle(base, added) {
+  return {
+    ...base?.bold ? { bold: true } : {},
+    ...base?.italic ? { italic: true } : {},
+    ...base?.underline ? { underline: true } : {},
+    ...added.bold ? { bold: true } : {},
+    ...added.italic ? { italic: true } : {},
+    ...added.underline ? { underline: true } : {}
+  };
+}
+function textStylesEqual(a, b) {
+  return Boolean(a?.bold) === Boolean(b?.bold) && Boolean(a?.italic) === Boolean(b?.italic) && Boolean(a?.underline) === Boolean(b?.underline);
+}
+function compactTextTokens(tokens) {
+  const compacted = [];
+  for (const token of tokens) {
+    const previous = compacted[compacted.length - 1];
+    if (previous?.kind === "text" && token.kind === "text" && textStylesEqual(previous.style, token.style)) {
+      previous.text += token.text;
+    } else {
+      compacted.push(token);
+    }
+  }
+  return compacted;
+}
+function styleKey(style) {
+  return `${style?.bold ? "b" : ""}${style?.italic ? "i" : ""}${style?.underline ? "u" : ""}`;
+}
+function pushFormattedTextTokens(tokens, text, sourceStart, formats) {
+  if (text.length === 0) {
+    tokens.push({ id: document2Id("text"), kind: "text", text });
+    return;
+  }
+  const styles = Array.from({ length: text.length });
+  for (const format of formats) {
+    const style = styleFromFormat(format);
+    if (!style || !Number.isFinite(format.start) || !Number.isFinite(format.end)) {
+      continue;
+    }
+    const start = Math.max(0, Math.min(text.length, Math.trunc(format.start) - sourceStart));
+    const end = Math.max(0, Math.min(text.length, Math.trunc(format.end) - sourceStart));
+    if (end <= start) {
+      continue;
+    }
+    for (let index = start; index < end; index += 1) {
+      styles[index] = mergeTextStyle(styles[index], style);
+    }
+  }
+  let chunkStart = 0;
+  for (let index = 1; index <= text.length; index += 1) {
+    if (index < text.length && styleKey(styles[index]) === styleKey(styles[chunkStart])) {
+      continue;
+    }
+    const chunk = text.slice(chunkStart, index);
+    const style = styles[chunkStart];
+    tokens.push({ id: document2Id("text"), kind: "text", text: chunk, ...style ? { style } : {} });
+    chunkStart = index;
   }
-  return { id: document2Id("field"), tokens };
 }
 function closingForList(command) {
   return command === "\\begin{itemize}" ? "\\end{itemize}" : "\\end{enumerate}";
@@ -1362,7 +1435,7 @@ function parseTextBlock(json, options, path, diagnostics) {
     id: document2Id("block"),
     kind: "textBlock",
     command: json.command,
-    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics),
+    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics, json.command === "\\paragraph" ? json.formats ?? [] : []),
     ...json.centered === true ? { centered: true } : {}
   };
 }
@@ -1371,7 +1444,7 @@ function parseListItem(json, options, path, diagnostics) {
   const blocksJson = Array.isArray(json.blocks) ? json.blocks : [];
   return {
     id: document2Id("item"),
-    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics),
+    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics, json.formats ?? []),
     blocks: blocksJson.map((block, index) => parseBlock(asBlockJson(block), options, `${path}.blocks[${String(index)}]`, diagnostics))
   };
 }
@@ -1404,7 +1477,8 @@ function parseTableBlock(json, options, path, diagnostics) {
       const spanCount = detectMathSpans2(value).length;
       const cellMathObjects = mathObjects.slice(mathObjectIndex, mathObjectIndex + spanCount);
       mathObjectIndex += spanCount;
-      return createInlineField2(value, cellMathObjects, options, `${path}.rows[${String(rowIndex)}][${String(columnIndex)}]`, diagnostics);
+      const cellFormats = json.cell_formats?.[rowIndex]?.[columnIndex] ?? [];
+      return createInlineField2(value, cellMathObjects, options, `${path}.rows[${String(rowIndex)}][${String(columnIndex)}]`, diagnostics, cellFormats);
     });
   });
   if (mathObjects.length > 0 && mathObjects.length !== mathObjectIndex) {
@@ -4444,6 +4518,79 @@ function normalizeFieldTokens(tokens) {
   }
   return tokens;
 }
+function textStylesEqual2(a, b) {
+  return Boolean(a?.bold) === Boolean(b?.bold) && Boolean(a?.italic) === Boolean(b?.italic) && Boolean(a?.underline) === Boolean(b?.underline);
+}
+function compactAdjacentTextTokens(tokens) {
+  const compacted = [];
+  for (const token of tokens) {
+    const previous = compacted[compacted.length - 1];
+    if (previous?.kind === "text" && token.kind === "text" && textStylesEqual2(previous.style, token.style)) {
+      previous.text += token.text;
+    } else {
+      compacted.push(token);
+    }
+  }
+  return normalizeFieldTokens(compacted);
+}
+function withoutEmptyStyle(style) {
+  const next = {};
+  if (style.bold) {
+    next.bold = true;
+  }
+  if (style.italic) {
+    next.italic = true;
+  }
+  if (style.underline) {
+    next.underline = true;
+  }
+  return next.bold || next.italic || next.underline ? next : void 0;
+}
+function textTokenPart(text, style, id = document2Id("text")) {
+  return { id, kind: "text", text, ...style ? { style } : {} };
+}
+function toggleTextTokenStyle(document2, fieldId, tokenId, selectionStart, selectionEnd, styleName) {
+  if (selectionEnd <= selectionStart) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  visitFields(next.blocks, (field) => {
+    if (field.id !== fieldId) {
+      return false;
+    }
+    const tokenIndex = field.tokens.findIndex((entry) => entry.id === tokenId && entry.kind === "text");
+    if (tokenIndex < 0) {
+      return true;
+    }
+    const token = field.tokens[tokenIndex];
+    const start = Math.max(0, Math.min(token.text.length, selectionStart));
+    const end = Math.max(0, Math.min(token.text.length, selectionEnd));
+    if (end <= start) {
+      return true;
+    }
+    const selectedStyle = token.style ?? {};
+    const enabled = selectedStyle[styleName] === true;
+    const nextStyle = withoutEmptyStyle({ ...selectedStyle, [styleName]: enabled ? void 0 : true });
+    const parts = [];
+    const before = token.text.slice(0, start);
+    const selected = token.text.slice(start, end);
+    const after = token.text.slice(end);
+    if (before.length > 0) {
+      parts.push(textTokenPart(before, token.style, token.id));
+    }
+    parts.push(textTokenPart(selected, nextStyle, before.length > 0 ? document2Id("text") : token.id));
+    if (after.length > 0) {
+      parts.push(textTokenPart(after, token.style));
+    }
+    field.tokens = compactAdjacentTextTokens([
+      ...field.tokens.slice(0, tokenIndex),
+      ...parts,
+      ...field.tokens.slice(tokenIndex + 1)
+    ]);
+    return true;
+  });
+  return next;
+}
 function stitchTextAroundRemovedToken(tokens, index) {
   const before = tokens[index - 1];
   const after = tokens[index + 1];
@@ -4471,8 +4618,8 @@ function removeMathTokenById(document2, tokenId) {
 function splitTextTokenAt(token, offset) {
   const safeOffset = Math.max(0, Math.min(offset, token.text.length));
   return [
-    { id: token.id, kind: "text", text: token.text.slice(0, safeOffset) },
-    { id: document2Id("text"), kind: "text", text: token.text.slice(safeOffset) }
+    { id: token.id, kind: "text", text: token.text.slice(0, safeOffset), ...token.style ? { style: token.style } : {} },
+    { id: document2Id("text"), kind: "text", text: token.text.slice(safeOffset), ...token.style ? { style: token.style } : {} }
   ];
 }
 function insertMathTokenAtCaret(document2, fieldId, textTokenId, caretOffset, session, opening = "$", closing = "$", side = "arabic") {
@@ -5214,9 +5361,22 @@ function mathBodyLatex(token) {
   const rendered = renderMathNodeLatex(token.math);
   return stripDisplayMathDelimiters(rendered);
 }
+function styledTextLatex(text, style) {
+  let output = text;
+  if (style?.bold) {
+    output = `\\textbf{${output}}`;
+  }
+  if (style?.italic) {
+    output = `\\textit{${output}}`;
+  }
+  if (style?.underline) {
+    output = `\\underline{${output}}`;
+  }
+  return output;
+}
 function tokenLatex(token) {
   if (token.kind === "text") {
-    return token.text;
+    return styledTextLatex(token.text, token.style);
   }
   if (token.kind === "cite") {
     return citeTokenLatex(token.keys);
@@ -5240,7 +5400,9 @@ function inlineFieldLatex(field) {
   return field.tokens.map((token) => tokenLatex(token)).join("");
 }
 function textBlockLatex(block) {
-  const body = `${block.command}{${inlineFieldLatex(block.field)}}`;
+  const content = inlineFieldLatex(block.field);
+  const body = block.command === "\\paragraph" ? `\\par
+${content}` : `${block.command}{${content}}`;
   if (block.command === "\\paragraph" && block.centered) {
     return `\\begin{center}
 ${body}
@@ -5492,7 +5654,7 @@ function mathTex(token, equationSide) {
 function previewInlines(field, islands, output, equationSide, document2, previewOptions) {
   return field.tokens.map((token) => {
     if (token.kind === "text") {
-      return { kind: "text", text: token.text };
+      return { kind: "text", text: token.text, ...token.style ? { style: token.style } : {} };
     }
     if (token.kind === "cite") {
       return {
@@ -5774,6 +5936,7 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   setDocument2References,
   stripDisplayMathDelimiters,
   toggleBlockInSelection,
+  toggleTextTokenStyle,
   updateCiteTokenKeys,
   updateDocument2ImageMeta,
   updateDocument2ImageValue,