@sobree/core 0.1.34 → 0.1.35

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;