@sobree/core 0.1.34 → 0.1.36

package/dist/editor/ops/clipboard.d.ts

@@ -0,0 +1,30 @@
+import { Block } from '../../doc/types';
+import { EditorContext } from '../context';
+/** Clipboard MIME for a Sobree block payload. The `+json` suffix and the
+ *  `web ` prefix browsers add for custom types both round-trip our reader. */
+export declare const BLOCKS_MIME = "application/x-sobree-blocks+json";
+/** Serialise blocks for the clipboard. */
+export declare function serializeBlocks(blocks: readonly Block[]): string;
+/** Parse a clipboard payload back to blocks, or `null` when the data isn't
+ *  ours / is malformed (caller then falls back to plain-text paste). */
+export declare function parseBlocks(data: string | undefined | null): Block[] | null;
+/**
+ * The whole blocks a selection covers, or `null` when the selection isn't
+ * block-level (a caret, or a partial selection inside one block).
+ */
+export declare function selectedWholeBlocks(ctx: EditorContext): Block[] | null;
+/** `copy` handler: write the covered whole blocks, or let the browser run
+ *  its default plain-text copy when none are covered. */
+export declare function onCopy(ctx: EditorContext, e: ClipboardEvent): void;
+/** `cut` handler: copy the covered whole blocks AND remove them (in
+ *  track-changes mode `deleteBlock` marks them instead). A partial in-block
+ *  selection falls through to the browser's default text cut. */
+export declare function onCut(ctx: EditorContext, e: ClipboardEvent): void;
+/**
+ * Paste handler hook for a structured block payload. Returns `true` when it
+ * consumed the event (block paste), `false` to let the normal text/image
+ * paste run. Inserts the pasted blocks after the caret's block, in order.
+ */
+export declare function tryPasteBlocks(ctx: EditorContext, e: ClipboardEvent): boolean;
+/** Insert `blocks` (deep-cloned, fresh ids) after the caret's block. */
+export declare function pasteBlocksAfterCaret(ctx: EditorContext, blocks: readonly Block[]): void;

package/dist/editor/view/docRenderer/sectionFlow.d.ts

@@ -12,10 +12,33 @@ import { SectionProperties } from '../../../doc/types';
  *   - `data-col-count`     — column count (every multi-column wrapper)
  *   - `data-pag-cid`       — stable section id, so the flow pass can
  *                            re-consolidate a section's per-page wrappers
+ *   - `data-col-fill`="1"  — fill column 0 to the page bottom, then column
+ *                            1 (newspaper) instead of balancing the last
+ *                            page; see `columnsFillNotBalance`
  *   - unequal: `data-col-widths-mm` + `data-col-gaps-mm` (explicit)
  *   - equal:   `data-col-gap-mm` (tracks sized by the flow pass)
+ *
+ * `nextSection` is the section that BEGINS immediately after this one; its
+ * break type is what TERMINATES this one, and so decides balance vs fill.
+ */
+export declare function openColumnContainerIfNeeded(host: HTMLElement, section: SectionProperties | undefined, sectionIndex?: number, nextSection?: SectionProperties | undefined): HTMLElement;
+/**
+ * Whether a multi-column section should FILL column-first (column 0 to the
+ * page bottom, then column 1) rather than balance its last page.
+ *
+ * Word balances a multi-column section's columns only when the section ends
+ * at a CONTINUOUS section break (or the document end); a section terminated
+ * by a hard page break (`nextPage` / `evenPage` / `oddPage`) fills column by
+ * column instead, leaving the second column short when the text runs out.
+ * `nextSection` is the section that begins right after — its break `type` is
+ * this section's terminator. No next section ⇒ document end ⇒ balance.
+ * (OOXML's `<w:type>` default is `nextPage`, so an unset type fills.)
  */
-export declare function openColumnContainerIfNeeded(host: HTMLElement, section: SectionProperties | undefined, sectionIndex?: number): HTMLElement;
+export declare function columnsFillNotBalance(nextSection: SectionProperties | undefined): boolean;
+/** Whether `section` begins on a fresh page — its break `type` is a hard
+ *  page break (`nextPage` / `evenPage` / `oddPage`). A continuous (or unset)
+ *  section continues on the running page. */
+export declare function sectionStartsOnFreshPage(section: SectionProperties | undefined): boolean;
 /**
  * If `container` is a column-flow container, move any trailing
  * visually-empty paragraphs out of it and append them to `host`. Keeps