@inshapardaz/likhari-react 0.1.18-dev.158 → 0.1.18-dev.165

package/dist/blocks/PoetryNode.d.ts

@@ -1,15 +1,23 @@
 import { type DOMConversionMap, type DOMExportOutput, type EditorConfig, type LexicalNode, type NodeKey, type SerializedElementNode, type Spread, ElementNode } from 'lexical';
-export type PoetryLayout = 'single' | 'two-column';
-export type PoetryAlign = 'justify' | 'left' | 'right' | 'start';
+export type PoetryLayout = 'single' | 'two-column' | 'staggered';
 /** Vertical space between couplets — an ordered scale the menu steps through. */
 export declare const POETRY_SPACINGS: readonly ["compact", "normal", "relaxed", "loose"];
 export type PoetrySpacing = (typeof POETRY_SPACINGS)[number];
 export declare const DEFAULT_POETRY_SPACING: PoetrySpacing;
+/** Horizontal space either side of the divider in two-column layout. */
+export declare const POETRY_GUTTERS: readonly ["compact", "normal", "relaxed", "loose"];
+export type PoetryGutter = (typeof POETRY_GUTTERS)[number];
+export declare const DEFAULT_POETRY_GUTTER: PoetryGutter;
+/** Width of each couplet box in staggered layout, as a share of the block. */
+export declare const POETRY_STAGGERS: readonly ["compact", "normal", "relaxed", "loose"];
+export type PoetryStagger = (typeof POETRY_STAGGERS)[number];
+export declare const DEFAULT_POETRY_STAGGER: PoetryStagger;
 export type SerializedPoetryBlockNode = Spread<{
     layout: PoetryLayout;
-    align: PoetryAlign;
     width?: number;
     spacing?: PoetrySpacing;
+    gutter?: PoetryGutter;
+    stagger?: PoetryStagger;
 }, SerializedElementNode>;
 /**
  * A poetry *section*: one or more couplets (two-line verse units) sharing
@@ -18,24 +26,24 @@ export type SerializedPoetryBlockNode = Spread<{
  * couplet its own LayoutContainerNode row (built on the columns primitive,
  * §4.9) — see blocks/poetryActions.ts's $getCouplets for how either shape
  * is read, and $setPoetryLayout/$exitPoetryOnEnter for how children are
- * restructured/grown between couplets and layouts. `layout` and `align`
- * apply to the whole section, not per couplet; both mutate in place via
- * poetryActions so converting a section between layouts doesn't lose
- * selection/undo coherence. One extensible primitive in place of four
- * fixed templates, per requirements doc §4.11.
+ * restructured/grown between couplets and layouts. `layout` applies to the
+ * whole section, not per couplet, and mutates in place via poetryActions so
+ * converting a section between layouts doesn't lose selection/undo
+ * coherence. One extensible primitive in place of four fixed templates,
+ * per requirements doc §4.11.
  */
 export declare class PoetryBlockNode extends ElementNode {
     __layout: PoetryLayout;
-    __align: PoetryAlign;
     /** User-chosen width in px (drag-resized), overriding editor.css's default
      * max-width: 70%. Undefined until the user resizes it. */
     __width?: number;
     __spacing: PoetrySpacing;
-    constructor(layout?: PoetryLayout, align?: PoetryAlign, width?: number, spacing?: PoetrySpacing, key?: NodeKey);
+    __gutter: PoetryGutter;
+    __stagger: PoetryStagger;
+    constructor(layout?: PoetryLayout, width?: number, spacing?: PoetrySpacing, gutter?: PoetryGutter, stagger?: PoetryStagger, key?: NodeKey);
     static getType(): string;
     static clone(node: PoetryBlockNode): PoetryBlockNode;
     getLayout(): PoetryLayout;
-    getAlign(): PoetryAlign;
     getWidth(): number | undefined;
     setWidth(width: number | undefined): this;
     /** Attribute-only — restructuring children for a layout change is
@@ -44,7 +52,10 @@ export declare class PoetryBlockNode extends ElementNode {
     setLayoutAttribute(layout: PoetryLayout): this;
     getSpacing(): PoetrySpacing;
     setSpacing(spacing: PoetrySpacing): this;
-    setAlign(align: PoetryAlign): this;
+    getGutter(): PoetryGutter;
+    setGutter(gutter: PoetryGutter): this;
+    getStagger(): PoetryStagger;
+    setStagger(stagger: PoetryStagger): this;
     static importJSON(serializedNode: SerializedPoetryBlockNode): PoetryBlockNode;
     exportJSON(): SerializedPoetryBlockNode;
     static importDOM(): DOMConversionMap | null;
@@ -54,6 +65,6 @@ export declare class PoetryBlockNode extends ElementNode {
     canBeEmpty(): false;
     isShadowRoot(): boolean;
 }
-export declare function $createPoetryBlockNode(layout?: PoetryLayout, align?: PoetryAlign, width?: number, spacing?: PoetrySpacing): PoetryBlockNode;
+export declare function $createPoetryBlockNode(layout?: PoetryLayout, width?: number, spacing?: PoetrySpacing, gutter?: PoetryGutter, stagger?: PoetryStagger): PoetryBlockNode;
 export declare function $isPoetryBlockNode(node: LexicalNode | null | undefined): node is PoetryBlockNode;
 //# sourceMappingURL=PoetryNode.d.ts.map

package/dist/blocks/PoetryNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PoetryNode.d.ts","sourceRoot":"","sources":["../../src/blocks/PoetryNode.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAC1B,KAAK,MAAM,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AACjE,iFAAiF;AACjF,eAAO,MAAM,eAAe,oDAAqD,CAAC;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAyB9D,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAC5C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,EACrF,qBAAqB,CACtB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB;8DAC0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;gBAGvB,MAAM,GAAE,YAAuB,EAC/B,KAAK,GAAE,WAAuB,EAC9B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE,aAAsC,EAC/C,GAAG,CAAC,EAAE,OAAO;IASf,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe;IAIpD,SAAS,IAAI,YAAY;IAIzB,QAAQ,IAAI,WAAW;IAIvB,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAMzC;;gEAE4D;IAC5D,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAM9C,UAAU,IAAI,aAAa;IAI3B,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAMxC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMlC,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,yBAAyB,GAAG,eAAe;IAI7E,UAAU,IAAI,yBAAyB;IAavC,MAAM,CAAC,SAAS,IAAI,gBAAgB,GAAG,IAAI;IAiB3C,SAAS,IAAI,eAAe;IAY5B,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW;IAa5C,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO;IAoBrF,UAAU,IAAI,KAAK;IAInB,YAAY,IAAI,OAAO;CAGxB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,YAAuB,EAC/B,KAAK,GAAE,WAAuB,EAC9B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,GAAE,aAAsC,GAC9C,eAAe,CAEjB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,IAAI,eAAe,CAEhG"}
+{"version":3,"file":"PoetryNode.d.ts","sourceRoot":"","sources":["../../src/blocks/PoetryNode.tsx"],"names":[],"mappings":"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"}

package/dist/blocks/PoetryNode.js

@@ -3,18 +3,22 @@ import { $applyNodeReplacement, ElementNode, } from 'lexical';
 /** Vertical space between couplets — an ordered scale the menu steps through. */
 export const POETRY_SPACINGS = ['compact', 'normal', 'relaxed', 'loose'];
 export const DEFAULT_POETRY_SPACING = 'normal';
-const VALID_LAYOUTS = new Set(['single', 'two-column']);
-const VALID_ALIGNS = new Set(['justify', 'left', 'right', 'start']);
+/** Horizontal space either side of the divider in two-column layout. */
+export const POETRY_GUTTERS = ['compact', 'normal', 'relaxed', 'loose'];
+export const DEFAULT_POETRY_GUTTER = 'normal';
+/** Width of each couplet box in staggered layout, as a share of the block. */
+export const POETRY_STAGGERS = ['compact', 'normal', 'relaxed', 'loose'];
+export const DEFAULT_POETRY_STAGGER = 'normal';
+const VALID_LAYOUTS = new Set(['single', 'two-column', 'staggered']);
 const VALID_SPACINGS = new Set(POETRY_SPACINGS);
-/** `text-align: justify` only stretches a line that actually wraps — a
- * misra short enough to fit on one line would otherwise just sit at its own
- * start edge instead of spreading its words across the full column width.
- * `text-align-last: justify` extends that same word-spacing stretch to the
- * single/last line too, so a one-line misra reads edge-to-edge exactly like
- * a wrapped one would. */
-function applyAlignStyle(element, align) {
-    element.style.textAlign = align;
-    element.style.textAlignLast = align === 'justify' ? 'justify' : '';
+const VALID_GUTTERS = new Set(POETRY_GUTTERS);
+const VALID_STAGGERS = new Set(POETRY_STAGGERS);
+/** Poetry is always justified: `text-align-last: justify` stretches a
+ * one-line misra across the full column width too, not just wrapped lines,
+ * so every line reads edge-to-edge. */
+function applyJustifyStyle(element) {
+    element.style.textAlign = 'justify';
+    element.style.textAlignLast = 'justify';
 }
 /** A user-dragged width overrides editor.css's default max-width: 70% —
  * clearing the inline style (rather than setting it to that same 70%)
@@ -32,32 +36,30 @@ function applyWidthStyle(element, width) {
  * couplet its own LayoutContainerNode row (built on the columns primitive,
  * §4.9) — see blocks/poetryActions.ts's $getCouplets for how either shape
  * is read, and $setPoetryLayout/$exitPoetryOnEnter for how children are
- * restructured/grown between couplets and layouts. `layout` and `align`
- * apply to the whole section, not per couplet; both mutate in place via
- * poetryActions so converting a section between layouts doesn't lose
- * selection/undo coherence. One extensible primitive in place of four
- * fixed templates, per requirements doc §4.11.
+ * restructured/grown between couplets and layouts. `layout` applies to the
+ * whole section, not per couplet, and mutates in place via poetryActions so
+ * converting a section between layouts doesn't lose selection/undo
+ * coherence. One extensible primitive in place of four fixed templates,
+ * per requirements doc §4.11.
  */
 export class PoetryBlockNode extends ElementNode {
-    constructor(layout = 'single', align = 'justify', width, spacing = DEFAULT_POETRY_SPACING, key) {
+    constructor(layout = 'single', width, spacing = DEFAULT_POETRY_SPACING, gutter = DEFAULT_POETRY_GUTTER, stagger = DEFAULT_POETRY_STAGGER, key) {
         super(key);
         this.__layout = layout;
-        this.__align = align;
         this.__width = width;
         this.__spacing = spacing;
+        this.__gutter = gutter;
+        this.__stagger = stagger;
     }
     static getType() {
         return 'poetry-couplet';
     }
     static clone(node) {
-        return new PoetryBlockNode(node.__layout, node.__align, node.__width, node.__spacing, node.__key);
+        return new PoetryBlockNode(node.__layout, node.__width, node.__spacing, node.__gutter, node.__stagger, node.__key);
     }
     getLayout() {
         return this.getLatest().__layout;
     }
-    getAlign() {
-        return this.getLatest().__align;
-    }
     getWidth() {
         return this.getLatest().__width;
     }
@@ -82,13 +84,24 @@ export class PoetryBlockNode extends ElementNode {
         writable.__spacing = spacing;
         return writable;
     }
-    setAlign(align) {
+    getGutter() {
+        return this.getLatest().__gutter;
+    }
+    setGutter(gutter) {
+        const writable = this.getWritable();
+        writable.__gutter = gutter;
+        return writable;
+    }
+    getStagger() {
+        return this.getLatest().__stagger;
+    }
+    setStagger(stagger) {
         const writable = this.getWritable();
-        writable.__align = align;
+        writable.__stagger = stagger;
         return writable;
     }
     static importJSON(serializedNode) {
-        return $createPoetryBlockNode(serializedNode.layout, serializedNode.align, serializedNode.width, serializedNode.spacing);
+        return $createPoetryBlockNode(serializedNode.layout, serializedNode.width, serializedNode.spacing, serializedNode.gutter, serializedNode.stagger);
     }
     exportJSON() {
         const width = this.getWidth();
@@ -97,8 +110,9 @@ export class PoetryBlockNode extends ElementNode {
             type: 'poetry-couplet',
             version: 1,
             layout: this.getLayout(),
-            align: this.getAlign(),
             spacing: this.getSpacing(),
+            gutter: this.getGutter(),
+            stagger: this.getStagger(),
             ...(width !== undefined ? { width } : {}),
         };
     }
@@ -109,53 +123,60 @@ export class PoetryBlockNode extends ElementNode {
                 if (!rawLayout)
                     return null;
                 const layout = VALID_LAYOUTS.has(rawLayout) ? rawLayout : 'single';
-                const rawAlign = domNode.getAttribute('data-likhari-poetry-align') ?? 'justify';
-                const align = VALID_ALIGNS.has(rawAlign) ? rawAlign : 'justify';
                 const rawWidth = Number(domNode.getAttribute('data-likhari-poetry-width'));
                 const width = Number.isFinite(rawWidth) && rawWidth > 0 ? rawWidth : undefined;
                 const rawSpacing = domNode.getAttribute('data-likhari-poetry-spacing');
                 const spacing = VALID_SPACINGS.has(rawSpacing) ? rawSpacing : DEFAULT_POETRY_SPACING;
-                return { conversion: () => ({ node: $createPoetryBlockNode(layout, align, width, spacing) }), priority: 2 };
+                const rawGutter = domNode.getAttribute('data-likhari-poetry-gutter');
+                const gutter = VALID_GUTTERS.has(rawGutter) ? rawGutter : DEFAULT_POETRY_GUTTER;
+                const rawStagger = domNode.getAttribute('data-likhari-poetry-stagger');
+                const stagger = VALID_STAGGERS.has(rawStagger) ? rawStagger : DEFAULT_POETRY_STAGGER;
+                return { conversion: () => ({ node: $createPoetryBlockNode(layout, width, spacing, gutter, stagger) }), priority: 2 };
             },
         };
     }
     exportDOM() {
         const element = document.createElement('div');
         element.setAttribute('data-likhari-poetry-layout', this.getLayout());
-        element.setAttribute('data-likhari-poetry-align', this.getAlign());
         element.setAttribute('data-likhari-poetry-spacing', this.getSpacing());
+        element.setAttribute('data-likhari-poetry-gutter', this.getGutter());
+        element.setAttribute('data-likhari-poetry-stagger', this.getStagger());
         const width = this.getWidth();
         if (width !== undefined)
             element.setAttribute('data-likhari-poetry-width', String(width));
-        applyAlignStyle(element, this.getAlign());
+        applyJustifyStyle(element);
         applyWidthStyle(element, width);
         return { element };
     }
     createDOM(config) {
         const element = document.createElement('div');
         const base = config.theme.poetry ?? 'likhari-poetry';
-        addClassNamesToElement(element, base, `${base}--${this.__layout}`, `${base}--spacing-${this.__spacing}`);
-        applyAlignStyle(element, this.__align);
+        addClassNamesToElement(element, base, `${base}--${this.__layout}`, `${base}--spacing-${this.__spacing}`, `${base}--gutter-${this.__gutter}`, `${base}--stagger-${this.__stagger}`);
+        applyJustifyStyle(element);
         applyWidthStyle(element, this.__width);
         return element;
     }
-    // Only ever adds/removes the layout modifier class, never touches the
-    // element's full className — the reconciler separately classList.adds the
-    // per-block ltr/rtl theme class (editor.css) onto this same element, and
-    // a wholesale className reassignment here would silently wipe it out.
+    // Only ever adds/removes modifier classes, never touches the element's full
+    // className — the reconciler separately classList.adds the per-block ltr/rtl
+    // theme class (editor.css) onto this same element, and a wholesale className
+    // reassignment here would silently wipe it out.
     updateDOM(prevNode, dom, config) {
+        const base = config.theme.poetry ?? 'likhari-poetry';
         if (prevNode.__layout !== this.__layout) {
-            const base = config.theme.poetry ?? 'likhari-poetry';
             dom.classList.remove(`${base}--${prevNode.__layout}`);
             dom.classList.add(`${base}--${this.__layout}`);
         }
         if (prevNode.__spacing !== this.__spacing) {
-            const base = config.theme.poetry ?? 'likhari-poetry';
             dom.classList.remove(`${base}--spacing-${prevNode.__spacing}`);
             dom.classList.add(`${base}--spacing-${this.__spacing}`);
         }
-        if (prevNode.__align !== this.__align) {
-            applyAlignStyle(dom, this.__align);
+        if (prevNode.__gutter !== this.__gutter) {
+            dom.classList.remove(`${base}--gutter-${prevNode.__gutter}`);
+            dom.classList.add(`${base}--gutter-${this.__gutter}`);
+        }
+        if (prevNode.__stagger !== this.__stagger) {
+            dom.classList.remove(`${base}--stagger-${prevNode.__stagger}`);
+            dom.classList.add(`${base}--stagger-${this.__stagger}`);
         }
         if (prevNode.__width !== this.__width) {
             applyWidthStyle(dom, this.__width);
@@ -169,8 +190,8 @@ export class PoetryBlockNode extends ElementNode {
         return true;
     }
 }
-export function $createPoetryBlockNode(layout = 'single', align = 'justify', width, spacing = DEFAULT_POETRY_SPACING) {
-    return $applyNodeReplacement(new PoetryBlockNode(layout, align, width, spacing));
+export function $createPoetryBlockNode(layout = 'single', width, spacing = DEFAULT_POETRY_SPACING, gutter = DEFAULT_POETRY_GUTTER, stagger = DEFAULT_POETRY_STAGGER) {
+    return $applyNodeReplacement(new PoetryBlockNode(layout, width, spacing, gutter, stagger));
 }
 export function $isPoetryBlockNode(node) {
     return node instanceof PoetryBlockNode;

package/dist/blocks/poetryActions.d.ts

@@ -1,5 +1,5 @@
 import { type ParagraphNode } from 'lexical';
-import { type PoetryAlign, type PoetryBlockNode, type PoetryLayout } from './PoetryNode.js';
+import { type PoetryBlockNode, type PoetryLayout } from './PoetryNode.js';
 /** One couplet's two misra paragraphs, in order. */
 export type Couplet = [ParagraphNode, ParagraphNode];
 /**
@@ -49,10 +49,10 @@ export declare function $ensureTrailingParagraph(node: PoetryBlockNode): void;
  * semantics, in its existing layout: "one poetry block can contain one or
  * more couplets, in one or two column layout", so a block's layout is
  * fixed once it has couplets, not chosen per couplet) and focuses its first
- * misra. Otherwise creates a new block (in `layout`/`align`) with one
+ * misra. Otherwise creates a new block (in `layout`) with one
  * couplet, after the selection's top-level element.
  */
-export declare function $insertPoetryCouplet(layout: PoetryLayout, align: PoetryAlign): boolean;
+export declare function $insertPoetryCouplet(layout: PoetryLayout): boolean;
 /** Removes the couplet the selection is inside. If it's the block's only
  * couplet, removes the whole block (an empty poetry section serves no
  * purpose) — the explicit, always-available counterpart to
@@ -60,17 +60,21 @@ export declare function $insertPoetryCouplet(layout: PoetryLayout, align: Poetry
  * menu's own "Delete table" action). */
 export declare function $deletePoetryCouplet(): boolean;
 /**
- * Backspace at the very start of an empty couplet removes just that
- * couplet — merging back into the previous one's end, or (if it's the
- * block's only couplet) removing the whole block, since an empty poetry
- * section serves no purpose. Otherwise there was no way to get rid of an
- * empty couplet created by mistake (its misra paragraphs each have their
- * own default canBeEmpty, so Lexical's usual "delete the empty block"
- * handling never reaches the couplet itself). Returns false for every
- * other caret position, including a non-empty couplet, so normal Backspace
- * handling (e.g. deleting within text) proceeds.
+ * Backspace at the start of a misra never merges it into its neighbour: the
+ * block's lines are paired into couplets, so merging one line away would
+ * shift every couplet after it (and take the previous couplet's last line
+ * with it). Instead, Backspace at the start of an empty couplet removes that
+ * couplet, and at the start of any other line it moves the caret to the end
+ * of the previous line. Other caret positions (deleting within text) fall
+ * through to normal handling.
  */
 export declare function $deletePoetryOnBackspace(): boolean;
+/**
+ * Forward Delete at the end of a misra never merges the next line into it, for
+ * the same reason as $deletePoetryOnBackspace: the caret moves to the start of
+ * the next line instead. Other caret positions fall through to normal handling.
+ */
+export declare function $deletePoetryForward(): boolean;
 /**
  * Enter inside a poetry block never grows a couplet past its fixed two
  * misras. The block's *last* couplet being completely empty is always the
@@ -91,4 +95,23 @@ export declare function $exitPoetryOnEnter(): boolean;
 /** Steps the caret's poetry block one notch looser (+1) or tighter (-1) on
  * the couplet-spacing scale; clamps at either end. */
 export declare function $adjustPoetrySpacing(step: 1 | -1): boolean;
+/** Steps the caret's two-column gutter one notch wider (+1) or narrower (-1);
+ * clamps at either end. */
+export declare function $adjustPoetryGutter(step: 1 | -1): boolean;
+/** Steps the caret's staggered couplet width one notch narrower (-1) or wider
+ * (+1); clamps at either end. */
+export declare function $adjustPoetryStagger(step: 1 | -1): boolean;
+/** Whether the couplet the caret is in is centered, or null outside a
+ * two-column poetry block (centering only applies there). */
+export declare function $getCoupletCenteredFromSelection(): boolean | null;
+/** Centers (or un-centers) the caret's couplet within a two-column block by
+ * rebuilding its row around the same two misra paragraphs. */
+export declare function $setCoupletCentered(centered: boolean): boolean;
+/** Removes the whole poetry block the caret is in, including every couplet. */
+export declare function $deletePoetryBlock(): boolean;
+/** Single-column blocks pair their paragraphs into couplets, so a line left
+ * without a partner (from pasted or imported content) would be invisible to
+ * the couplet logic. Give it an empty partner instead, so every line belongs
+ * to a couplet and can be deleted like any other. */
+export declare function $completeSingleCoupletBlock(node: PoetryBlockNode): void;
 //# sourceMappingURL=poetryActions.d.ts.map

package/dist/blocks/poetryActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poetryActions.d.ts","sourceRoot":"","sources":["../../src/blocks/poetryActions.ts"],"names":[],"mappings":"AACA,OAAO,EAA4F,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvI,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,EAAE,CAgB7D;AAED;;6CAE6C;AAC7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,EAAE,CAE1E;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,eAAe,GAAG,IAAI,CAKrE;AA0DD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAevF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmBlF;AAED;;;;;;qDAMqD;AACrD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAiBtF;AAED;;;;wCAIwC;AACxC,wBAAgB,oBAAoB,IAAI,OAAO,CAwB9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAqClD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAgD5C;AAED;sDACsD;AACtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAO1D"}
+{"version":3,"file":"poetryActions.d.ts","sourceRoot":"","sources":["../../src/blocks/poetryActions.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,oDAAoD;AACpD,MAAM,MAAM,OAAO,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,EAAE,CAqB7D;AAED;;6CAE6C;AAC7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,EAAE,CAE1E;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,eAAe,GAAG,IAAI,CAKrE;AA0DD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAevF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmBlF;AAED;;;;;;qDAMqD;AACrD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAiBlE;AAED;;;;wCAIwC;AACxC,wBAAgB,oBAAoB,IAAI,OAAO,CAwB9C;AAUD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAsClD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAgD5C;AAED;sDACsD;AACtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAO1D;AAED;2BAC2B;AAC3B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAOzD;AAED;iCACiC;AACjC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAO1D;AAYD;6DAC6D;AAC7D,wBAAgB,gCAAgC,IAAI,OAAO,GAAG,IAAI,CAUjE;AAED;8DAC8D;AAC9D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAuB9D;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,IAAI,OAAO,CAK5C;AAED;;;qDAGqD;AACrD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAGvE"}