dopecanvas 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -185,6 +185,12 @@ export declare interface DopeCanvasHandle {
     undo: () => boolean;
     /** Redo the last undone edit. Returns false if nothing to redo. */
     redo: () => boolean;
+    /** Insert a page break after the block at the cursor (or at end) */
+    insertPageBreak: () => void;
+    /** Show or hide visual page break indicators */
+    setShowPageBreaks: (show: boolean) => void;
+    /** Get the current show-page-breaks state */
+    getShowPageBreaks: () => boolean;
 }
 
 export declare interface DopeCanvasProps {
@@ -192,6 +198,8 @@ export declare interface DopeCanvasProps {
     html?: string;
     /** Optional CSS to inject alongside the HTML */
     css?: string;
+    /** Rendering mode: paginated pages or continuous flow */
+    renderMode?: 'paged' | 'flow';
     /** Page configuration */
     pageConfig?: PageConfig;
     /** Callback when content changes */
@@ -254,6 +262,30 @@ export declare class EditableManager {
     getPlainText(): string;
 }
 
+/**
+ * Comprehensive formatting state for the current selection.
+ * Consumers use this to reflect active states in toolbar UI.
+ */
+export declare interface FormattingState {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    justifyLeft: boolean;
+    justifyCenter: boolean;
+    justifyRight: boolean;
+    justifyFull: boolean;
+    orderedList: boolean;
+    unorderedList: boolean;
+    superscript: boolean;
+    subscript: boolean;
+    fontName: string;
+    fontSize: string;
+    foreColor: string;
+    backColor: string;
+    formatBlock: string;
+}
+
 /** Page sizes in pixels at 96 DPI */
 export declare const PAGE_SIZE_PRESETS: Record<PageSizeName, PageDimensions>;
 
@@ -330,6 +362,31 @@ export declare interface PaginationResult {
     pageCount: number;
 }
 
+/**
+ * Recombine adjacent split blocks back into their original block.
+ * Call this before re-measuring / re-paginating so that the
+ * splitter can re-evaluate where to split.
+ *
+ * Takes an array of block HTML strings and returns a new array
+ * with split blocks merged.
+ */
+export declare function recombineSplitBlocks(blockHTMLs: string[]): string[];
+
+export declare interface SelectionSaver {
+    /** Call on mouseDown of a toolbar control to snapshot the current selection */
+    saveSelection: () => void;
+    /** Restore a previously saved selection */
+    restoreSelection: () => void;
+    /** Restore the selection and then run a callback (convenience) */
+    restoreAndExec: (fn: () => void) => void;
+}
+
+/** Result of splitting a block */
+export declare interface SplitResult {
+    firstHTML: string;
+    secondHTML: string;
+}
+
 export declare const TextToolbar: default_2.FC<TextToolbarProps>;
 
 declare interface TextToolbarProps {
@@ -348,6 +405,16 @@ declare interface ToolbarProps {
     onPageConfigChange: (config: Partial<PageConfig>) => void;
 }
 
+/**
+ * Try to split a block element so that the first piece fits
+ * within `availableHeight` pixels. Returns null if the block
+ * cannot be split (too small, unsplittable tag, etc.).
+ *
+ * The element must be in the DOM (attached to a measurement
+ * container) so that getBoundingClientRect / Range work.
+ */
+export declare function trySplitBlock(element: HTMLElement, availableHeight: number): SplitResult | null;
+
 /** Unsubscribe function returned by event listeners */
 export declare type Unsubscribe = () => void;
 
@@ -371,20 +438,23 @@ declare interface UseDocumentEngineReturn {
 }
 
 /**
- * Hook to query the current formatting state (bold, italic, etc.)
- * from the browser's selection.
+ * Hook to query the current formatting state (bold, italic, font, etc.)
+ * from the browser's selection. Updates reactively on every
+ * `selectionchange` event.
+ *
+ * Returns the full `FormattingState` object — consumers can use any
+ * fields they need for their own toolbar UI.
  */
-export declare function useFormattingState(): {
-    bold: boolean;
-    italic: boolean;
-    underline: boolean;
-    strikethrough: boolean;
-    justifyLeft: boolean;
-    justifyCenter: boolean;
-    justifyRight: boolean;
-    justifyFull: boolean;
-};
+export declare function useFormattingState(): FormattingState;
 
 export declare function useSelectionContext(editableManager: EditableManager | null): ToolbarContext;
 
+/**
+ * Hook that provides save/restore helpers for the browser selection.
+ * Use `saveSelection` as the `onMouseDown` handler on toolbar controls,
+ * then call `restoreAndExec(fn)` inside the control's `onChange` /
+ * `onClick` to restore the selection before running the format command.
+ */
+export declare function useSelectionSaver(): SelectionSaver;
+
 export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dopecanvas",
-  "version": "0.1.2",
-  "description": "The office suite built for the AI era — a drop-in React component that renders LLM-generated HTML as paginated, editable documents.",
+  "version": "0.1.4",
+  "description": "The office editor built for the AI era — a drop-in React component that renders LLM-generated HTML as paginated, editable documents.",
   "type": "module",
   "license": "MIT",
   "author": "DopeOffice",