@sofereditor/react 0.6.0 → 0.9.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. */
@@ -264,6 +286,15 @@ interface UseEditorResult {
         cellIndex?: number;
         embed: ImageEmbed;
     } | null;
+    /**
+     * Passthrough of `UseEditorOptions.uploadImage` — `undefined` when not
+     * configured. Exposed so callers with the editor instance but not the
+     * original options (the `<Editor>` component's paste handler, notably) can
+     * upload an image without going through `insertImageFromFile` (which also
+     * inserts it — not always what's wanted, e.g. resolving `data:` embeds
+     * already inside a pasted slice before `insertSlice`).
+     */
+    uploadImage?: (file: File) => Promise<string>;
 }
 declare function useEditor(opts?: UseEditorOptions): UseEditorResult;
 
@@ -330,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`
@@ -380,8 +423,14 @@ declare function renderInline(delta: DeltaOp[], keyPrefix: number | string): Rea
 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 {
@@ -474,4 +523,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. */
@@ -264,6 +286,15 @@ interface UseEditorResult {
         cellIndex?: number;
         embed: ImageEmbed;
     } | null;
+    /**
+     * Passthrough of `UseEditorOptions.uploadImage` — `undefined` when not
+     * configured. Exposed so callers with the editor instance but not the
+     * original options (the `<Editor>` component's paste handler, notably) can
+     * upload an image without going through `insertImageFromFile` (which also
+     * inserts it — not always what's wanted, e.g. resolving `data:` embeds
+     * already inside a pasted slice before `insertSlice`).
+     */
+    uploadImage?: (file: File) => Promise<string>;
 }
 declare function useEditor(opts?: UseEditorOptions): UseEditorResult;
 
@@ -330,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`
@@ -380,8 +423,14 @@ declare function renderInline(delta: DeltaOp[], keyPrefix: number | string): Rea
 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 {
@@ -474,4 +523,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 };