@sobree/core 0.1.33 → 0.1.35

package/dist/docx/drawing/inline.d.ts

@@ -30,6 +30,19 @@ export interface InlineFramesContext {
     /** Theme colour palette (from `word/theme/theme1.xml`) so textbox /
      *  shape fills declared as `<a:schemeClr>` resolve instead of vanishing. */
     theme?: ThemePalette;
+    /**
+     * Body content width in EMU (page width − left/right margins). Needed
+     * only to lay out a paragraph that holds MORE THAN ONE inline drawing
+     * (a tab-separated row of "Place Illustration here" boxes): the boxes
+     * are merged into one frame whose coordinate system IS the content
+     * column, so each box's x is a true fraction of the column. Absent ⇒
+     * single-drawing paragraphs only, no row layout.
+     */
+    contentWidthEmu?: number;
+    /** `<w:defaultTabStop>` in twips — the grid a `<w:tab>` advances to when
+     *  the paragraph declares no explicit `<w:tabs>`. Drives the column
+     *  positions of a multi-drawing row. Absent ⇒ Word's 720-twip default. */
+    defaultTabStopTwips?: number;
 }
 /**
  * One InlineFrame plus the source DOM nodes it came from.

package/dist/docx/drawing/presetGeometry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Expand DrawingML PRESET geometries that a CSS box can't draw — arrows,
+ * callouts, and the like — into an SVG outline. Box-expressible presets
+ * (rect / ellipse / roundedRect / line) stay as geometry enums via
+ * `readGeometry`; this module only handles presets that genuinely need a
+ * path, and returns `null` for everything else so that fallback stands.
+ *
+ * The outline is emitted in the frame's OWN `widthEmu × heightEmu` box so
+ * the renderer's `preserveAspectRatio="none"` scale is 1:1 — a normalised
+ * square box would shear the arrowhead when the frame isn't square.
+ *
+ * Adjustment handles (`<a:avLst><a:gd name="adjN" fmla="val …"/>`) tune
+ * the shaft thickness and head length; absent ⇒ ECMA-376 factory
+ * defaults. Reading them keeps the shape faithful to the source instead
+ * of guessing proportions.
+ */
+export interface PresetPath {
+    widthEmu: number;
+    heightEmu: number;
+    d: string;
+}
+/** Expand the shape's `<a:prstGeom>` into a path, or `null` when the
+ *  preset is box-expressible / unmodelled (caller keeps `readGeometry`). */
+export declare function expandPresetGeometry(wsp: Element, dims: {
+    widthEmu: number;
+    heightEmu: number;
+}): PresetPath | null;

package/dist/docx/drawing/shapeProps.d.ts

@@ -1,8 +1,10 @@
 import { FrameBorder } from '../../doc/types';
 import { ThemePalette } from './colors';
 /** Map `<a:prstGeom prst>` to the AST's preset geometry enum; unknown
- *  presets fall back to `rect`. (Custom geometry is handled separately by
- *  the anchored reader via `customGeometry`.) */
+ *  presets fall back to `rect`. Only the box-expressible presets live
+ *  here — those a CSS rectangle (± border-radius) can draw. Presets that
+ *  need a real outline (arrows, callouts) are expanded to an SVG path by
+ *  `presetGeometry`, and `<a:custGeom>` by `customGeometry`. */
 export declare function readGeometry(wsp: Element): "rect" | "ellipse" | "roundedRect" | "line";
 /**
  * First `<a:solidFill>` directly inside the shape's `spPr` (wps or pic) —

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;