oasis-editor 0.0.90 → 0.0.92

package/dist/core/engine.d.ts

@@ -14,6 +14,21 @@ export interface FloatingExclusionRect {
         y: number;
     }>;
 }
+/**
+ * Automatic-hyphenation configuration resolved from `EditorDocument.settings`
+ * (`w:autoHyphenation` and friends). Threaded to the composer so words can break
+ * at line ends with a rendered trailing hyphen.
+ */
+export interface HyphenationLayoutOptions {
+    /** `w:autoHyphenation`: master switch. */
+    enabled: boolean;
+    /** `w:hyphenationZone`: min trailing gap (points) before hyphenating. */
+    zone?: number;
+    /** `w:consecutiveHyphenLimit`: max consecutive hyphenated lines (0/undefined = unlimited). */
+    consecutiveLimit?: number;
+    /** `w:doNotHyphenateCaps`: skip all-caps words. */
+    doNotHyphenateCaps?: boolean;
+}
 export interface TextMeasureOptions {
     paragraph: EditorParagraphNode;
     fragments: EditorLayoutFragment[];
@@ -21,6 +36,7 @@ export interface TextMeasureOptions {
     contentWidth?: number;
     defaultTabStop?: number;
     exclusions?: FloatingExclusionRect[];
+    hyphenation?: HyphenationLayoutOptions;
 }
 export interface ITextMeasurer {
     composeMeasuredParagraphLines(options: TextMeasureOptions): EditorLayoutLine[];

package/dist/core/model/index.d.ts

@@ -7,8 +7,8 @@
  * re-export in `src/core/model.ts`.
  */
 export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, } from './types/primitives.js';
-export type { EditorTextStyle, EditorParagraphStyle, EditorTableStyle, EditorTableFloatingLayout, EditorTableConditionalFormat, EditorConditionalRowStyle, EditorTableConditionalType, EditorTableConditionalFlags, EditorNamedStyle, } from './types/styles.js';
-export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorParagraphNode, EditorTableCellStyle, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
+export type { EditorTextStyle, EditorParagraphStyle, EditorTableStyle, EditorTableFloatingLayout, EditorTableConditionalFormat, EditorConditionalRowStyle, EditorTableConditionalType, EditorTableConditionalFlags, EditorTableCellStyle, EditorNamedStyle, } from './types/styles.js';
+export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorParagraphNode, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
 export type { RunKind, RunOfKind, RunVisitor } from './runKind.js';
 export { getRunKind, isInlineObjectRun, visitRun, getRunImage, getRunTextBox, getRunField, getRunFieldChar, getRunFieldInstruction, getRunFootnoteReference, getRunEndnoteReference, getRunSym, } from './runKind.js';
 export type { EditorFootnote } from './types/documentFootnotes.js';

package/dist/core/model/types/document.d.ts

@@ -86,6 +86,16 @@ export interface EditorDocument {
     styles?: Record<string, EditorNamedStyle>;
     settings?: {
         defaultTabStop?: number;
+        /** `w:allowSpaceOfSameStyleInTable`: contextual spacing applies in table cells. */
+        allowSpaceOfSameStyleInTable?: boolean;
+        /** `w:autoHyphenation`: automatically hyphenate words at line ends. */
+        autoHyphenation?: boolean;
+        /** `w:consecutiveHyphenLimit`: max consecutive lines ending with a hyphen (0 = unlimited). */
+        consecutiveHyphenLimit?: number;
+        /** `w:hyphenationZone`: min trailing gap (points) before a word is hyphenated. */
+        hyphenationZone?: number;
+        /** `w:doNotHyphenateCaps`: do not hyphenate all-caps words. */
+        doNotHyphenateCaps?: boolean;
     };
     /**
      * Out-of-band asset registry. Image runs reference entries here using

package/dist/core/model/types/layout.d.ts

@@ -37,6 +37,15 @@ export interface EditorLayoutLine {
     slots: EditorCaretSlot[];
     fragments: EditorLayoutFragment[];
     availableWidth?: number;
+    /**
+     * Set when the line ends mid-word due to automatic hyphenation. Renderers draw
+     * a trailing hyphen glyph after the last fragment; it is not part of the text
+     * model (no caret slot/offset), so caret and selection logic ignore it.
+     */
+    trailingHyphen?: boolean;
+    /** Advance (px) reserved/drawn for the trailing hyphen; the single source of
+     * truth shared by alignment and the canvas/PDF renderers. */
+    trailingHyphenWidth?: number;
 }
 export interface EditorLayoutParagraph {
     paragraphId: string;

package/dist/core/model/types/nodes.d.ts

@@ -1,5 +1,5 @@
-import { EditorBorderStyle, EditorDocxWidthValue, EditorEndnoteReferenceData, EditorFieldChar, EditorFieldData, EditorFootnoteReferenceData, EditorImageFloatingLayout, EditorImageRunData, EditorParagraphListStyle, EditorRevision, EditorPropertyRevision, EditorStructuralRevision, EditorTableRowHeightRule } from './primitives.js';
-import { EditorParagraphStyle, EditorTableStyle, EditorTableConditionalFlags, EditorTextStyle } from './styles.js';
+import { EditorDocxWidthValue, EditorEndnoteReferenceData, EditorFieldChar, EditorFieldData, EditorFootnoteReferenceData, EditorImageFloatingLayout, EditorImageRunData, EditorParagraphListStyle, EditorRevision, EditorPropertyRevision, EditorStructuralRevision, EditorTableRowHeightRule } from './primitives.js';
+import { EditorParagraphStyle, EditorTableCellStyle, EditorTableStyle, EditorTableConditionalFlags, EditorTextStyle } from './styles.js';
 
 /**
  * Geometry/appearance of a text box shape (`wps:spPr`). All values are
@@ -153,44 +153,6 @@ export interface EditorParagraphNode {
     /** Drop cap that body text in this paragraph wraps around, when present. */
     dropCap?: EditorDropCap;
 }
-export interface EditorTableCellStyle {
-    shading?: string;
-    width?: number | string;
-    borderTop?: EditorBorderStyle;
-    borderRight?: EditorBorderStyle;
-    borderBottom?: EditorBorderStyle;
-    borderLeft?: EditorBorderStyle;
-    /** Bidi-aware leading/trailing borders (`w:start` / `w:end`). */
-    borderStart?: EditorBorderStyle;
-    borderEnd?: EditorBorderStyle;
-    /** Diagonal cell borders (`w:tl2br` / `w:tr2bl`). */
-    borderTopLeftToBottomRight?: EditorBorderStyle;
-    borderTopRightToBottomLeft?: EditorBorderStyle;
-    padding?: number;
-    paddingTop?: number;
-    paddingRight?: number;
-    paddingBottom?: number;
-    paddingLeft?: number;
-    /** Bidi-aware leading/trailing margins (`w:start` / `w:end`). */
-    paddingStart?: number;
-    paddingEnd?: number;
-    verticalAlign?: "top" | "middle" | "bottom";
-    horizontalAlign?: "left" | "center" | "right" | "justify";
-    /** `w:tcPr/w:textDirection/@w:val`: cell text flow direction (vertical text). */
-    textDirection?: "lrTb" | "tbRl" | "btLr" | "lrTbV" | "tbRlV" | null;
-    /** `w:noWrap`: prevent normal wrapping inside the cell. */
-    noWrap?: boolean;
-    /** `w:tcFitText`: request Word-style text fitting within the cell width. */
-    fitText?: boolean;
-    /** `w:hideMark`: hide the cell-end marker for layout. */
-    hideMark?: boolean;
-    /** `w:headers/@w:val`: semantic header cell references. */
-    headers?: string;
-    /** Structural `cellIns`/`cellDel`/`cellMerge` revision. */
-    revision?: EditorStructuralRevision;
-    /** Previous cell properties from `w:tcPrChange`. */
-    propertyRevision?: EditorPropertyRevision<EditorTableCellStyle>;
-}
 export interface EditorTableCellNode {
     id: string;
     blocks: EditorParagraphNode[];
@@ -201,6 +163,8 @@ export interface EditorTableCellNode {
     conditionalStyle?: EditorTableConditionalFlags;
     /** Exact pre-change cell grid retained while a tracked merge/split is pending. */
     mergeRevisionState?: EditorTableMergeRevisionState;
+    /** Extension attributes (e.g. `w14:paraId`) preserved for round-trip. */
+    extAttributes?: Record<string, string>;
 }
 export interface EditorTableMergeRevisionState {
     revisionId: string;
@@ -217,6 +181,8 @@ export interface EditorTableRowStyle {
     gridAfter?: number;
     widthBefore?: EditorDocxWidthValue;
     widthAfter?: EditorDocxWidthValue;
+    /** `w:jc` in `w:trPr`: horizontal alignment of the row within the table width. */
+    align?: "left" | "center" | "right";
     /** `w:cantSplit`: keep this row together during pagination. */
     cantSplit?: boolean;
     /** `w:hidden`: do not display this row in normal view. */
@@ -235,10 +201,16 @@ export interface EditorTableRowNode {
     style?: EditorTableRowStyle;
     conditionalStyle?: EditorTableConditionalFlags;
     /**
-     * Raw w:tblPrEx XML (per-row table property exceptions), serialized verbatim
-     * before w:trPr. Preserved for DOCX round-trip fidelity only; not editable.
+     * `w:tblPrEx` — per-row table property exceptions. These override the table's
+     * own properties (borders, cell margins, cell spacing, indent, width, layout,
+     * alignment) for the cells in this row. Applied during cell formatting
+     * resolution and re-serialized before `w:trPr` on export.
      */
-    tblPrExXml?: string;
+    propertyExceptions?: EditorTableStyle;
+    /** Raw `<w:tblPrExChange ...>` XML preserved for DOCX round-trip. */
+    tblPrExChangeXml?: string;
+    /** Extension attributes (e.g. `w14:paraId`, `w15:*`) preserved for round-trip. */
+    extAttributes?: Record<string, string>;
 }
 export interface EditorTableNode {
     id: string;

package/dist/core/model/types/styles.d.ts

@@ -1,5 +1,4 @@
-import { EditorBorderStyle, EditorDocxWidthValue, EditorEmphasisMark, EditorLigatures, EditorNumberForm, EditorNumberSpacing, EditorPropertyRevision, EditorTabStop, EditorTextLanguage, EditorUnderlineStyle } from './primitives.js';
-import { EditorTableCellStyle } from './nodes.js';
+import { EditorBorderStyle, EditorDocxWidthValue, EditorEmphasisMark, EditorLigatures, EditorNumberForm, EditorNumberSpacing, EditorPropertyRevision, EditorStructuralRevision, EditorTabStop, EditorTextLanguage, EditorUnderlineStyle } from './primitives.js';
 
 export interface EditorTextStyle {
     styleId?: string;
@@ -100,6 +99,44 @@ export interface EditorConditionalRowStyle {
     cantSplit?: boolean;
     hidden?: boolean;
 }
+export interface EditorTableCellStyle {
+    shading?: string;
+    width?: number | string;
+    borderTop?: EditorBorderStyle;
+    borderRight?: EditorBorderStyle;
+    borderBottom?: EditorBorderStyle;
+    borderLeft?: EditorBorderStyle;
+    /** Bidi-aware leading/trailing borders (`w:start` / `w:end`). */
+    borderStart?: EditorBorderStyle;
+    borderEnd?: EditorBorderStyle;
+    /** Diagonal cell borders (`w:tl2br` / `w:tr2bl`). */
+    borderTopLeftToBottomRight?: EditorBorderStyle;
+    borderTopRightToBottomLeft?: EditorBorderStyle;
+    padding?: number;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    /** Bidi-aware leading/trailing margins (`w:start` / `w:end`). */
+    paddingStart?: number;
+    paddingEnd?: number;
+    verticalAlign?: "top" | "middle" | "bottom";
+    horizontalAlign?: "left" | "center" | "right" | "justify";
+    /** `w:tcPr/w:textDirection/@w:val`: cell text flow direction (vertical text). */
+    textDirection?: "lrTb" | "tbRl" | "btLr" | "lrTbV" | "tbRlV" | null;
+    /** `w:noWrap`: prevent normal wrapping inside the cell. */
+    noWrap?: boolean;
+    /** `w:tcFitText`: request Word-style text fitting within the cell width. */
+    fitText?: boolean;
+    /** `w:hideMark`: hide the cell-end marker for layout. */
+    hideMark?: boolean;
+    /** `w:headers/@w:val`: semantic header cell references. */
+    headers?: string;
+    /** Structural `cellIns`/`cellDel`/`cellMerge` revision. */
+    revision?: EditorStructuralRevision;
+    /** Previous cell properties from `w:tcPrChange`. */
+    propertyRevision?: EditorPropertyRevision<EditorTableCellStyle>;
+}
 export interface EditorTableConditionalFormat {
     shading?: string;
     /** Run formatting (bold/color) from the conditional's `w:rPr`. */

package/dist/core/tableStyleResolver.d.ts

@@ -1,4 +1,5 @@
-import { EditorNamedStyle, EditorParagraphStyle, EditorTableCellStyle, EditorTableNode, EditorTableRowStyle, EditorTableStyle, EditorTextStyle } from './model.js';
+import { EditorNamedStyle, EditorParagraphStyle, EditorTableCellStyle, EditorTableStyle, EditorTextStyle } from './model/types/styles.js';
+import { EditorTableNode, EditorTableRowStyle } from './model/types/nodes.js';
 
 export interface ResolvedTableCellFormatting {
     tableStyle: EditorTableStyle;

package/dist/export/docx/docxPackageXml.d.ts

@@ -4,5 +4,11 @@ import { DocContext, PartDefinition } from './docxTypes.js';
 export declare function buildContentTypesXml(hasNumbering: boolean, imageExtensions: Iterable<string>, hasSettings: boolean, parts: PartDefinition[], hasFootnotes: boolean, hasEndnotes: boolean, hasStyles: boolean, hasComments: boolean): string;
 export declare function buildRootRelationshipsXml(): string;
 export declare function buildDocumentRelationshipsXml(hasNumbering: boolean, hasSettings: boolean, images: DocContext["images"], hyperlinks: DocContext["hyperlinks"], parts: PartDefinition[], hasFootnotes: boolean, hasEndnotes: boolean, hasStyles: boolean, hasComments: boolean): string;
-export declare function buildSettingsXml(hasEvenAndOddHeaders: boolean, defaultTabStop?: number, footnoteSettings?: EditorFootnoteSettings, endnoteSettings?: EditorFootnoteSettings): string;
+export interface HyphenationSettingsXml {
+    autoHyphenation?: boolean;
+    consecutiveHyphenLimit?: number;
+    hyphenationZone?: number;
+    doNotHyphenateCaps?: boolean;
+}
+export declare function buildSettingsXml(hasEvenAndOddHeaders: boolean, defaultTabStop?: number, footnoteSettings?: EditorFootnoteSettings, endnoteSettings?: EditorFootnoteSettings, allowSpaceOfSameStyleInTable?: boolean, hyphenation?: HyphenationSettingsXml): string;
 export declare function buildPartRelationshipsXml(images: DocContext["images"], hyperlinks: DocContext["hyperlinks"]): string;

package/dist/import/docx/settings.d.ts

@@ -2,7 +2,12 @@ import { EditorFootnoteSettings, EditorEndnoteSettings } from '../../core/model.
 
 export interface DocxSettings {
     adjustLineHeightInTable: boolean;
+    allowSpaceOfSameStyleInTable?: boolean;
     defaultTabStop?: number;
+    autoHyphenation?: boolean;
+    consecutiveHyphenLimit?: number;
+    hyphenationZone?: number;
+    doNotHyphenateCaps?: boolean;
     footnoteSettings?: EditorFootnoteSettings;
     endnoteSettings?: EditorEndnoteSettings;
 }

package/dist/import/docx/tableConditionalFormatting.d.ts

@@ -1,5 +1,4 @@
 import { Element as XmlElement } from '@xmldom/xmldom';
-import { EditorNamedStyle, EditorParagraphNode, EditorParagraphStyle, EditorTableConditionalFormat, EditorTextStyle } from '../../core/model.js';
 
 export interface TableLook {
     firstRow: boolean;
@@ -17,32 +16,3 @@ export interface TableLook {
  * on.
  */
 export declare function parseTableLook(tblPr: XmlElement | null): TableLook;
-/**
- * Returns the table-style conditional-format keys that apply to a cell at the
- * given position, ordered low→high precedence (later entries override earlier
- * ones). Mirrors Word's resolution order: whole table < bands < first/last col
- * < first/last row < corner cells. Banding and first/last row/col are gated by
- * `tblLook`; banding parity is computed over the "body" rows/cols that remain
- * after excluding the special first/last row/col.
- */
-export declare function resolveCellConditionalKeys(rowIndex: number, colIndex: number, rowCount: number, colCount: number, look: TableLook, rowBandSize: number, colBandSize: number): string[];
-/** Merges resolved conditional formats (low→high precedence) into one. */
-export declare function mergeConditionalFormats(keys: string[], conditionals: Record<string, EditorTableConditionalFormat> | undefined): EditorTableConditionalFormat;
-/**
- * Applies a conditional run text style (bold/color from the table style)
- * beneath each run's own style, so explicit run formatting still wins.
- */
-export declare function applyConditionalTextStyle(paragraphs: EditorParagraphNode[], textStyle: EditorTextStyle | undefined): void;
-/**
- * Filter a table style's paragraph properties (its `<w:pPr>`) so they sit at the
- * correct OOXML precedence for a given cell paragraph.
- *
- * Per ECMA-376 §17.7.2 the order (low → high) is:
- *   docDefaults < table style < paragraph style < direct formatting.
- * So any property the paragraph's own (named) style explicitly defines must win
- * over the table style. We strip those keys from the inherited table-style pPr;
- * what remains only fills gaps the paragraph style leaves open. Without this, a
- * table style like `TableGrid` (which sets `spacing after="0"`) would wrongly
- * override Normal's `after="120"` and collapse cell row height vs Word.
- */
-export declare function tableStyleParagraphInheritance(tableStylePPr: EditorParagraphStyle | undefined, paragraphStyleId: string | undefined, styles: Record<string, EditorNamedStyle> | undefined): EditorParagraphStyle | undefined;

package/dist/import/docx/tableProperties.d.ts

@@ -8,6 +8,13 @@ export declare function parseTableStyle(tblPr: XmlElement | null, tableStyleId?:
 export declare function parseTableRowStyle(rowProperties: XmlElement | null): EditorTableRowStyle | undefined;
 export declare function getTableCellColSpan(cellProperties: XmlElement | null): number;
 export declare function getTableCellVMerge(cellProperties: XmlElement | null): "restart" | "continue" | undefined;
+/**
+ * Legacy horizontal merge marker (`w:hMerge`). Like `w:vMerge`, `restart`
+ * begins a merged run and an omitted/`continue` value continues it. Modern Word
+ * uses `w:gridSpan` instead; on import we collapse `hMerge` runs into the
+ * anchor cell's colspan so both representations render identically.
+ */
+export declare function getTableCellHMerge(cellProperties: XmlElement | null): "restart" | "continue" | undefined;
 export declare function parseTableCellStyle(cellProperties: XmlElement | null, tableDefaultMargins?: EditorTableStyle["defaultCellMargins"]): EditorTableCellStyle | undefined;
 export declare function isTableHeaderRow(rowNode: XmlElement): boolean;
 /**

package/dist/import/docx/xmlHelpers.d.ts

@@ -11,6 +11,11 @@ export declare function parseTextDirection(value: string | null | undefined): Do
 export declare function getFirstChildByTagNameNS(element: XmlElement | null | undefined, namespace: string, localName: string): XmlElement | null;
 export declare function getAttributeValue(element: XmlElement | null, localName: string): string | null;
 export declare function findElementDeep(element: XmlElement, localName: string): XmlElement | null;
+/**
+ * Collects non-WORD_NS extension attributes (e.g. `w14:paraId`, `w15:*`) from
+ * a table/row/cell element for round-trip preservation.
+ */
+export declare function collectExtAttributes(element: XmlElement): Record<string, string> | undefined;
 export declare function isWordTrue(value: string | null | undefined): boolean;
 export declare function parseOnOffProperty(parent: XmlElement, localName: string): boolean | undefined;
 export declare function parseStyleIdProperty(parent: XmlElement | null, localName: "pStyle" | "rStyle"): string | undefined;