@sobree/core 0.1.47 → 0.1.48

package/dist/doc/types/paragraph.d.ts

@@ -14,6 +14,17 @@ export interface ParagraphProperties {
     indent?: ParagraphIndent;
     borders?: ParagraphBorders;
     shading?: Shading;
+    /**
+     * `<w:contextualSpacing/>` (ECMA-376 §17.3.1.9) — omit this
+     * paragraph's before/after spacing when the adjacent paragraph uses
+     * the SAME paragraph style. Word/LibreOffice collapse the inter-
+     * paragraph gap to zero between consecutive same-style paragraphs
+     * (the classic case: double-spaced thesis body, or tight bulleted
+     * lists). The renderer suppresses the corresponding margin only when
+     * the neighbour shares this paragraph's style — see
+     * `applyParagraphProps`.
+     */
+    contextualSpacing?: boolean;
     /** Keep this paragraph on the same page as the next one. */
     keepNext?: boolean;
     /** Don't allow this paragraph to break across pages. */

package/dist/docx/types.d.ts

@@ -33,6 +33,9 @@ export interface ParagraphFormat {
     spacingAfterTwips?: number;
     /** Explicit `<w:spacing w:before>` in twips. */
     spacingBeforeTwips?: number;
+    /** `<w:contextualSpacing/>` toggle — omit before/after spacing between
+     *  same-style neighbours (ECMA-376 §17.3.1.9). */
+    contextualSpacing?: boolean;
     /** Raw numbering reference (`numId`, `ilvl`) if this para is part of a list. */
     numId?: number;
     numLevel?: number;

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

@@ -1,2 +1,3 @@
 import { NamedStyle, Paragraph } from '../../../doc/types';
-export declare function renderParagraph(p: Paragraph, styles: readonly NamedStyle[], rawParts: Record<string, Uint8Array>): HTMLElement;
+import { ContextualNeighbors } from './properties';
+export declare function renderParagraph(p: Paragraph, styles: readonly NamedStyle[], rawParts: Record<string, Uint8Array>, contextualNeighbors?: ContextualNeighbors): HTMLElement;

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

@@ -1,2 +1,14 @@
 import { NamedStyle, ParagraphProperties, RunProperties } from '../../../doc/types';
-export declare function applyParagraphProps(el: HTMLElement, props: ParagraphProperties, styles?: readonly NamedStyle[]): RunProperties;
+/**
+ * Whether each side of a paragraph sits next to a same-style paragraph.
+ * Used to resolve `<w:contextualSpacing/>`: the before/after margin is
+ * dropped only when the corresponding neighbour shares this paragraph's
+ * style. The block walker (`renderBlocks`) owns the sequence and computes
+ * these; `applyParagraphProps` combines them with the resolved
+ * `contextualSpacing` flag (which may come from the style cascade).
+ */
+export interface ContextualNeighbors {
+    prevSameStyle: boolean;
+    nextSameStyle: boolean;
+}
+export declare function applyParagraphProps(el: HTMLElement, props: ParagraphProperties, styles?: readonly NamedStyle[], contextualNeighbors?: ContextualNeighbors): RunProperties;