@sofereditor/react 0.7.0 → 0.10.0

package/dist/index.d.cts

@@ -153,6 +153,16 @@ interface ImageCaptionRequest {
      */
     resolve: (result: ImageCaptionResult | null) => void;
 }
+interface FormulaResult {
+    latex: string;
+    display: boolean;
+}
+interface FormulaRequest {
+    initialLatex: string;
+    initialDisplay: boolean;
+    /** Resolve com a fórmula, ou null no cancelamento. */
+    resolve: (result: FormulaResult | null) => void;
+}
 interface UseEditorResult {
     doc: EditorDocument;
     history: EditorHistory;
@@ -218,6 +228,11 @@ interface UseEditorResult {
     requestImageCaption: (initialCaption?: string, initialAlign?: CaptionAlign) => Promise<ImageCaptionResult | null>;
     /** Resolver called by `<ImageCaptionDialog>` on apply/cancel. */
     resolveImageCaptionRequest: (result: ImageCaptionResult | null) => void;
+    formulaRequest: FormulaRequest | null;
+    requestFormula: (initialLatex?: string, initialDisplay?: boolean) => Promise<FormulaResult | null>;
+    resolveFormulaRequest: (result: FormulaResult | null) => void;
+    /** Renderiza o LaTeX, gera SVG + PNG e insere como embed na seleção. */
+    insertFormula: (latex: string, display: boolean) => Promise<void>;
     /** True iff the focus position lies inside a table cell. */
     isInTable: () => boolean;
     /** Returns `{blockIndex, row, col}` for the focus position, or null when outside a table. */
@@ -238,7 +253,14 @@ interface UseEditorResult {
     mergeRight: () => boolean;
     mergeDown: () => boolean;
     splitCell: () => boolean;
-    setColumnWidth: (blockIndex: number, col: number, widthPx: number) => void;
+    /** Move a divisa `boundary` (entre a coluna `boundary` e a `boundary+1`) por `deltaPct` pontos percentuais. */
+    setColumnBoundary: (blockIndex: number, boundary: number, deltaPct: number, base?: number[]) => void;
+    /** Define a largura total da tabela como percentual da largura útil da página. */
+    setTableWidth: (blockIndex: number, pct: number) => void;
+    /** Grava a altura de UMA linha, em px. É um mínimo, não fixo. */
+    setRowHeight: (blockIndex: number, row: number, px: number) => void;
+    /** Grava o array de alturas inteiro numa única transação. */
+    setRowHeights: (blockIndex: number, heights: number[]) => void;
     /** Returns the table rectangle if the current selection is a multi-cell range, else null. */
     getTableRect: () => TableRect | null;
     /** True when there's a rectangular table-cell selection. */
@@ -339,6 +361,18 @@ declare function PageConfigDialog(): JSX.Element | null;
  */
 declare function ImageCaptionDialog(): JSX.Element | null;
 
+/**
+ * Modal de fórmula. Espelha `ImageCaptionDialog` — dirigido por
+ * `editor.formulaRequest`.
+ *
+ * O preview usa o MESMO renderer que a inserção vai usar. Se o preview falha,
+ * o botão de inserir fica desabilitado: nunca inserir um embed cujo render
+ * falhou, senão entra no documento um <img> quebrado.
+ */
+declare function FormulaDialog({ fontsDirectory, }: {
+    fontsDirectory?: string;
+}): JSX.Element | null;
+
 /**
  * Reactive snapshot of an `EditorDocument`'s page settings. Re-renders the
  * component when `docSettings` changes (either locally via `setPageSettings`
@@ -383,14 +417,27 @@ declare function NodeView({ block, index, children, fragment, tableFragment }: N
  *
  * Keys are stable on `${blockIndex}-${runningOffset}` so React reconciliation
  * survives split/merge of runs under collaboration.
+ *
+ * `baseOffset` shifts every emitted `data-embed-offset` (and key) by a fixed
+ * amount. Needed when `delta` is only a SLICE of a larger model range — e.g.
+ * one line of a célula-lista, where each `<li>` gets its own line-local delta
+ * but `data-embed-offset` must stay in CELL coordinates (contract with
+ * `Editor.tsx`'s embed-selection and `ImageResizeOverlay`'s DOM query).
+ * Defaults to 0, which reproduces the old line-local numbering exactly.
  */
-declare function renderInline(delta: DeltaOp[], keyPrefix: number | string): ReactNode;
+declare function renderInline(delta: DeltaOp[], keyPrefix: number | string, baseOffset?: number): ReactNode;
 
 interface EditorProviderProps {
     editor: UseEditorResult;
     children: ReactNode;
+    /**
+     * De onde servir as 20 fontes .woff2 do MathLive (296 KB). Sem elas o
+     * campo desenha com fonte do sistema — feio e SILENCIOSO. O caminho muda
+     * por app por causa do base path, então é o app que sabe.
+     */
+    mathliveFontsDirectory?: string;
 }
-declare function EditorProvider({ editor, children }: EditorProviderProps): JSX.Element;
+declare function EditorProvider({ editor, children, mathliveFontsDirectory, }: EditorProviderProps): JSX.Element;
 declare function useEditorContext(): UseEditorResult;
 
 interface ToolbarProps {
@@ -472,10 +519,11 @@ declare function applyDomSelection(root: HTMLElement, modelSel: Selection): void
  *    com o marcador (número/símbolo) como texto literal dentro de um span
  *    `mso-list:Ignore`. `parseWordListLevel` + a exclusão desse span tratam isso.
  *
- * fontFamily é deliberadamente NUNCA emitida: a escola padroniza Arial e cada
- * documento tem sua própria tipografia (mesma decisão de `import-docx`, que
- * descarta `w:rFonts`). fontSize É preservado (ver `parseFontSizePt`): o
- * modelo já suporta a mark, a barra já tem controle de tamanho, e descartar o
+ * fontFamily é deliberadamente NUNCA emitida: a escola padroniza uma fonte só,
+ * definida no CSS (`.ed-root`) e cada documento tem sua própria tipografia
+ * (mesma decisão de `import-docx`, que descarta `w:rFonts`). fontSize É
+ * preservado (ver `parseFontSizePt`): o modelo já suporta a mark, a barra já
+ * tem controle de tamanho, e descartar o
  * tamanho perdia informação real (título de 37.5pt colado do Google Docs saía
  * do tamanho do corpo). Unidades que dependem do contexto de herança do
  * documento de origem (em/rem/%/larger/smaller/medium) não são resolvíveis
@@ -483,4 +531,4 @@ declare function applyDomSelection(root: HTMLElement, modelSel: Selection): void
  */
 declare function htmlToSlice(html: string): ClipboardSlice | null;
 
-export { A4_PAGE, type BlockFragment, type CaptionAlign, Editor, type EditorProps, EditorProvider, type EditorProviderProps, ImageCaptionDialog, type ImageCaptionRequest, type ImageCaptionResult, LinkDialog, type LinkRequest, NodeView, type NodeViewFragment, PageConfigDialog, type PageConfigRequest, type PageEntry, type PageGeometry, type PageLayout, type PageLayoutResult, type PageRenderContext, type PageRenderProp, type PageSlot, type PaginationPhase, type PendingMarks, RemoteCursorsOverlay, type TableRowFragment, Toolbar, type ToolbarProps, type UseEditorOptions, type UseEditorResult, applyDomSelection, contentHeight, contentWidth, defaultPageLayout, deltaLength, findBlockIndex, getBlockElement, getCellElement, getFragmentForOffset, htmlToSlice, isTableRectSelection, locatePoint, readDomSelection, renderInline, selectionsEqual, sliceDelta, textOffsetWithin, useEditor, useEditorContext, usePageLayout, usePageSettings };
+export { A4_PAGE, type BlockFragment, type CaptionAlign, Editor, type EditorProps, EditorProvider, type EditorProviderProps, FormulaDialog, ImageCaptionDialog, type ImageCaptionRequest, type ImageCaptionResult, LinkDialog, type LinkRequest, NodeView, type NodeViewFragment, PageConfigDialog, type PageConfigRequest, type PageEntry, type PageGeometry, type PageLayout, type PageLayoutResult, type PageRenderContext, type PageRenderProp, type PageSlot, type PaginationPhase, type PendingMarks, RemoteCursorsOverlay, type TableRowFragment, Toolbar, type ToolbarProps, type UseEditorOptions, type UseEditorResult, applyDomSelection, contentHeight, contentWidth, defaultPageLayout, deltaLength, findBlockIndex, getBlockElement, getCellElement, getFragmentForOffset, htmlToSlice, isTableRectSelection, locatePoint, readDomSelection, renderInline, selectionsEqual, sliceDelta, textOffsetWithin, useEditor, useEditorContext, usePageLayout, usePageSettings };

package/dist/index.d.ts

@@ -153,6 +153,16 @@ interface ImageCaptionRequest {
      */
     resolve: (result: ImageCaptionResult | null) => void;
 }
+interface FormulaResult {
+    latex: string;
+    display: boolean;
+}
+interface FormulaRequest {
+    initialLatex: string;
+    initialDisplay: boolean;
+    /** Resolve com a fórmula, ou null no cancelamento. */
+    resolve: (result: FormulaResult | null) => void;
+}
 interface UseEditorResult {
     doc: EditorDocument;
     history: EditorHistory;
@@ -218,6 +228,11 @@ interface UseEditorResult {
     requestImageCaption: (initialCaption?: string, initialAlign?: CaptionAlign) => Promise<ImageCaptionResult | null>;
     /** Resolver called by `<ImageCaptionDialog>` on apply/cancel. */
     resolveImageCaptionRequest: (result: ImageCaptionResult | null) => void;
+    formulaRequest: FormulaRequest | null;
+    requestFormula: (initialLatex?: string, initialDisplay?: boolean) => Promise<FormulaResult | null>;
+    resolveFormulaRequest: (result: FormulaResult | null) => void;
+    /** Renderiza o LaTeX, gera SVG + PNG e insere como embed na seleção. */
+    insertFormula: (latex: string, display: boolean) => Promise<void>;
     /** True iff the focus position lies inside a table cell. */
     isInTable: () => boolean;
     /** Returns `{blockIndex, row, col}` for the focus position, or null when outside a table. */
@@ -238,7 +253,14 @@ interface UseEditorResult {
     mergeRight: () => boolean;
     mergeDown: () => boolean;
     splitCell: () => boolean;
-    setColumnWidth: (blockIndex: number, col: number, widthPx: number) => void;
+    /** Move a divisa `boundary` (entre a coluna `boundary` e a `boundary+1`) por `deltaPct` pontos percentuais. */
+    setColumnBoundary: (blockIndex: number, boundary: number, deltaPct: number, base?: number[]) => void;
+    /** Define a largura total da tabela como percentual da largura útil da página. */
+    setTableWidth: (blockIndex: number, pct: number) => void;
+    /** Grava a altura de UMA linha, em px. É um mínimo, não fixo. */
+    setRowHeight: (blockIndex: number, row: number, px: number) => void;
+    /** Grava o array de alturas inteiro numa única transação. */
+    setRowHeights: (blockIndex: number, heights: number[]) => void;
     /** Returns the table rectangle if the current selection is a multi-cell range, else null. */
     getTableRect: () => TableRect | null;
     /** True when there's a rectangular table-cell selection. */
@@ -339,6 +361,18 @@ declare function PageConfigDialog(): JSX.Element | null;
  */
 declare function ImageCaptionDialog(): JSX.Element | null;
 
+/**
+ * Modal de fórmula. Espelha `ImageCaptionDialog` — dirigido por
+ * `editor.formulaRequest`.
+ *
+ * O preview usa o MESMO renderer que a inserção vai usar. Se o preview falha,
+ * o botão de inserir fica desabilitado: nunca inserir um embed cujo render
+ * falhou, senão entra no documento um <img> quebrado.
+ */
+declare function FormulaDialog({ fontsDirectory, }: {
+    fontsDirectory?: string;
+}): JSX.Element | null;
+
 /**
  * Reactive snapshot of an `EditorDocument`'s page settings. Re-renders the
  * component when `docSettings` changes (either locally via `setPageSettings`
@@ -383,14 +417,27 @@ declare function NodeView({ block, index, children, fragment, tableFragment }: N
  *
  * Keys are stable on `${blockIndex}-${runningOffset}` so React reconciliation
  * survives split/merge of runs under collaboration.
+ *
+ * `baseOffset` shifts every emitted `data-embed-offset` (and key) by a fixed
+ * amount. Needed when `delta` is only a SLICE of a larger model range — e.g.
+ * one line of a célula-lista, where each `<li>` gets its own line-local delta
+ * but `data-embed-offset` must stay in CELL coordinates (contract with
+ * `Editor.tsx`'s embed-selection and `ImageResizeOverlay`'s DOM query).
+ * Defaults to 0, which reproduces the old line-local numbering exactly.
  */
-declare function renderInline(delta: DeltaOp[], keyPrefix: number | string): ReactNode;
+declare function renderInline(delta: DeltaOp[], keyPrefix: number | string, baseOffset?: number): ReactNode;
 
 interface EditorProviderProps {
     editor: UseEditorResult;
     children: ReactNode;
+    /**
+     * De onde servir as 20 fontes .woff2 do MathLive (296 KB). Sem elas o
+     * campo desenha com fonte do sistema — feio e SILENCIOSO. O caminho muda
+     * por app por causa do base path, então é o app que sabe.
+     */
+    mathliveFontsDirectory?: string;
 }
-declare function EditorProvider({ editor, children }: EditorProviderProps): JSX.Element;
+declare function EditorProvider({ editor, children, mathliveFontsDirectory, }: EditorProviderProps): JSX.Element;
 declare function useEditorContext(): UseEditorResult;
 
 interface ToolbarProps {
@@ -472,10 +519,11 @@ declare function applyDomSelection(root: HTMLElement, modelSel: Selection): void
  *    com o marcador (número/símbolo) como texto literal dentro de um span
  *    `mso-list:Ignore`. `parseWordListLevel` + a exclusão desse span tratam isso.
  *
- * fontFamily é deliberadamente NUNCA emitida: a escola padroniza Arial e cada
- * documento tem sua própria tipografia (mesma decisão de `import-docx`, que
- * descarta `w:rFonts`). fontSize É preservado (ver `parseFontSizePt`): o
- * modelo já suporta a mark, a barra já tem controle de tamanho, e descartar o
+ * fontFamily é deliberadamente NUNCA emitida: a escola padroniza uma fonte só,
+ * definida no CSS (`.ed-root`) e cada documento tem sua própria tipografia
+ * (mesma decisão de `import-docx`, que descarta `w:rFonts`). fontSize É
+ * preservado (ver `parseFontSizePt`): o modelo já suporta a mark, a barra já
+ * tem controle de tamanho, e descartar o
  * tamanho perdia informação real (título de 37.5pt colado do Google Docs saía
  * do tamanho do corpo). Unidades que dependem do contexto de herança do
  * documento de origem (em/rem/%/larger/smaller/medium) não são resolvíveis
@@ -483,4 +531,4 @@ declare function applyDomSelection(root: HTMLElement, modelSel: Selection): void
  */
 declare function htmlToSlice(html: string): ClipboardSlice | null;
 
-export { A4_PAGE, type BlockFragment, type CaptionAlign, Editor, type EditorProps, EditorProvider, type EditorProviderProps, ImageCaptionDialog, type ImageCaptionRequest, type ImageCaptionResult, LinkDialog, type LinkRequest, NodeView, type NodeViewFragment, PageConfigDialog, type PageConfigRequest, type PageEntry, type PageGeometry, type PageLayout, type PageLayoutResult, type PageRenderContext, type PageRenderProp, type PageSlot, type PaginationPhase, type PendingMarks, RemoteCursorsOverlay, type TableRowFragment, Toolbar, type ToolbarProps, type UseEditorOptions, type UseEditorResult, applyDomSelection, contentHeight, contentWidth, defaultPageLayout, deltaLength, findBlockIndex, getBlockElement, getCellElement, getFragmentForOffset, htmlToSlice, isTableRectSelection, locatePoint, readDomSelection, renderInline, selectionsEqual, sliceDelta, textOffsetWithin, useEditor, useEditorContext, usePageLayout, usePageSettings };
+export { A4_PAGE, type BlockFragment, type CaptionAlign, Editor, type EditorProps, EditorProvider, type EditorProviderProps, FormulaDialog, ImageCaptionDialog, type ImageCaptionRequest, type ImageCaptionResult, LinkDialog, type LinkRequest, NodeView, type NodeViewFragment, PageConfigDialog, type PageConfigRequest, type PageEntry, type PageGeometry, type PageLayout, type PageLayoutResult, type PageRenderContext, type PageRenderProp, type PageSlot, type PaginationPhase, type PendingMarks, RemoteCursorsOverlay, type TableRowFragment, Toolbar, type ToolbarProps, type UseEditorOptions, type UseEditorResult, applyDomSelection, contentHeight, contentWidth, defaultPageLayout, deltaLength, findBlockIndex, getBlockElement, getCellElement, getFragmentForOffset, htmlToSlice, isTableRectSelection, locatePoint, readDomSelection, renderInline, selectionsEqual, sliceDelta, textOffsetWithin, useEditor, useEditorContext, usePageLayout, usePageSettings };