oasis-editor 0.0.136 → 0.0.138

package/dist/core/commands/table/tableCellStyleCommands.d.ts

@@ -3,6 +3,9 @@ import { EditorBorderStyle, EditorState, EditorTableCellStyle } from '../../mode
 export type TableBorderPreset = "bottom" | "top" | "left" | "right" | "none" | "all" | "outside" | "inside" | "insideHorizontal" | "insideVertical" | "diagonalDown" | "diagonalUp";
 /** Word's default border: black, solid, one half point. */
 export declare const DEFAULT_TABLE_BORDER: EditorBorderStyle;
+/** Explicitly suppresses a border. Missing cell borders intentionally fall
+ * back to the editor's default visible table border. */
+export declare const NO_TABLE_BORDER: EditorBorderStyle;
 export declare function setTableCellStyleValue<K extends keyof EditorTableCellStyle>(state: EditorState, key: K, value: EditorTableCellStyle[K] | null): EditorState;
 export declare function setTableCellWidth(state: EditorState, width: number | string | null): EditorState;
 export declare function setTableCellBorders(state: EditorState, border: EditorBorderStyle | null): EditorState;

package/dist/core/commands/table/tableRowCommands.d.ts

@@ -3,6 +3,7 @@ import { EditorState, EditorTableRowStyle } from '../../model.js';
 export declare function setSelectedTableRowStyleValue<K extends keyof EditorTableRowStyle>(state: EditorState, key: K, value: EditorTableRowStyle[K] | null): EditorState;
 export declare function setSelectedTableRowHeader(state: EditorState, value: boolean | null): EditorState;
 export declare function setTableRowHeight(state: EditorState, tableId: string, rowIndex: number, height: number | string | null): EditorState;
+export declare function setTableRowHeights(state: EditorState, tableId: string, rowHeights: Readonly<Record<number, number | string | null>>): EditorState;
 /**
  * Equalize the heights of every row in the active table (Word's "Distribute
  * Rows"). Uses the tallest explicit row height as the target (or a default when

package/dist/core/editorState/defaultStyles.d.ts

@@ -1,3 +1,4 @@
 import { EditorNamedStyle } from '../model.js';
 
+export declare const DEFAULT_TABLE_STYLES: Record<string, EditorNamedStyle>;
 export declare const DEFAULT_EDITOR_STYLES: Record<string, EditorNamedStyle>;

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

@@ -8,7 +8,7 @@
  */
 export type { EditorUnderlineStyle, EditorLigatures, EditorNumberSpacing, EditorNumberForm, EditorTextLanguage, EditorBorderStyle, EditorEmphasisMark, EditorTabStop, EditorParagraphListStyle, EditorImageCrop, EditorImageFillMode, EditorLineDash, EditorImageBorder, EditorImageFloatingPosition, EditorImageFloatingLayout, EditorImageRunData, EditorWrapPolygonPoint, EditorFieldData, EditorFieldChar, EditorFootnoteReferenceData, EditorEndnoteReferenceData, EditorRevision, EditorRevisionMetadata, EditorStructuralRevision, EditorPropertyRevision, EditorAsset, EditorFootnoteNumberFormat, EditorFootnoteRestart, EditorDocxWidthValue, EditorTableLayout, EditorTableRowHeightRule, EditorGradientStop, EditorTextFill, EditorTextOutline, EditorTextShadow, EditorGlow, EditorReflection, } from './types/primitives.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, EditorSdtBlockWrapper, EditorParagraphNode, EditorTableCellNode, EditorTableRowStyle, EditorTableRowNode, EditorTableNode, EditorBlockNode, } from './types/nodes.js';
+export type { EditorRunBase, EditorTextRun, EditorTextBoxShape, EditorTextBoxBody, EditorTextBoxData, EditorDropCap, EditorSdtBlockWrapper, EditorSdtPr, EditorSdtSubtype, EditorSdtListItem, EditorSdtDataBinding, 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/nodes.d.ts

@@ -148,17 +148,135 @@ export interface EditorDropCap {
  * A block-level structured document tag (`w:sdt`, a content control) enclosing
  * one or more blocks, preserved for round-trip. Its content is unwrapped into the
  * normal block flow (so it still renders and edits); this carries the wrapper's
- * properties verbatim so export can re-wrap. `groupId` ties together the
- * consecutive blocks that came from the same `w:sdt`; the array on a block lists
- * its enclosing wrappers outermost-first (nested content controls).
+ * properties so export can re-wrap. `groupId` ties together the consecutive blocks
+ * that came from the same `w:sdt`; the array on a block lists its enclosing
+ * wrappers outermost-first (nested content controls).
+ *
+ * Recognized `w:sdtPr` children are parsed into the typed `sdtPr` object so the
+ * editor can read the control's alias/tag/id/lock/subtype/etc. Unknown children
+ * (extension namespaces, future-schema elements) are preserved verbatim in
+ * `sdtPr.unknownXml` so export re-emits them byte-for-byte. Likewise `sdtEndPr`
+ * is preserved as raw XML; structured-document end properties rarely carry
+ * editor-meaningful data beyond run formatting that the content already supplies.
  */
 export interface EditorSdtBlockWrapper {
     groupId: string;
-    /** Raw `<w:sdtPr>…</w:sdtPr>` XML, or empty when the tag had no properties. */
-    sdtPrXml: string;
+    /** Parsed `<w:sdtPr>` properties (alias, tag, id, lock, subtype, etc.). */
+    sdtPr: EditorSdtPr;
     /** Raw `<w:sdtEndPr>…</w:sdtEndPr>` XML, when present. */
     sdtEndPrXml?: string;
 }
+/**
+ * Recognized `<w:sdtPr>` children. Every field is optional; a property is only
+ * present if the matching element was in the source markup. Property order in
+ * OOXML is significant (CT_SdtPr schema sequence: `rPr`, `alias`, `tag`, `id`,
+ * `lock`, `placeholder`, `dataBinding`,
+ * `temporary`, `equation`/`citation`/`bibliography`/`group`/`picture`/`text`/
+ * `richText`/`comboBox`/`dropDownList`/`date`/`repeatingSection`/
+ * `repeatingSectionItem`, extension elements). The exporter emits them in this
+ * sequence to keep documents schema-valid.
+ */
+export interface EditorSdtPr {
+    /** `<w:alias w:val="…"/>` — friendly display name. */
+    alias?: string;
+    /** `<w:tag w:val="…"/>` — programmatic tag for template automation. */
+    tag?: string;
+    /** `<w:id w:val="…"/>` — stable content-control id (stored as a string for fidelity). */
+    id?: string;
+    /** `<w:lock w:val="…"/>` — sdtLocked/contentLocked/sdtContentLocked combinations. */
+    lock?: string;
+    /**
+     * `<w:appearance w:val="…"/>` — boundingBox|tags|hidden. Editor-UI hint, not layout.
+     */
+    appearance?: "boundingBox" | "tags" | "hidden" | string;
+    /** `<w:showingPlcHdr w:val="…"/>` — true when the control currently shows its placeholder text. */
+    showingPlcHdr?: boolean;
+    /** `<w:temporary w:val="…"/>` — remove the control after the first edit. */
+    temporary?: boolean;
+    /** `<w:color w:val="…"/>` — UI color of the content-control chrome. */
+    color?: string;
+    /** `<w:placeholder><w:docPart w:val="…"/></w:placeholder>` — glossary entry name. */
+    placeholderDocPart?: string;
+    /** `<w:dataBinding>` — custom-XML store binding. */
+    dataBinding?: EditorSdtDataBinding;
+    /** Recognized content-control subtype element (`<w:text>`, `<w:dropDownList>`, …). */
+    subtype?: EditorSdtSubtype;
+    /**
+     * Serialized XML of every `w:sdtPr` child the parser did not recognize, in
+     * document order, so a future-proof round-trip re-emits extension/future-schema
+     * elements (e.g. `w15:storeItem`, `w14:*` extension attributes) without loss.
+     */
+    unknownXml?: string;
+}
+/** Recognized content-control subtypes (the single typed child of `w:sdtPr`). */
+export type EditorSdtSubtype = {
+    kind: "text";
+    multiline?: boolean;
+} | {
+    kind: "richText";
+} | {
+    kind: "picture";
+} | {
+    kind: "group";
+} | {
+    kind: "equation";
+} | {
+    kind: "citation";
+} | {
+    kind: "bibliography";
+} | {
+    kind: "comboBox";
+    /** Display/value pairs from `<w:listItem>` children. */
+    listItems?: EditorSdtListItem[];
+    /** `<w:lastSelectedValue w:val="…"/>` if a value was chosen on last save. */
+    lastSelectedValue?: string;
+} | {
+    kind: "dropDownList";
+    listItems?: EditorSdtListItem[];
+    lastSelectedValue?: string;
+} | {
+    kind: "date";
+    /** `<w:date w:fullDate="…"/>` — the chosen date-time (ISO 8601). */
+    fullDate?: string;
+    /** `<w:dateFormat w:val="…"/>` — display format string (e.g. `M/d/yyyy`). */
+    dateFormat?: string;
+    /** `<w:lid w:val="…"/>` — locale id for calendar formatting. */
+    lid?: string;
+    /** `<w:calendar w:val="…"/>` — gregorian|gregorianUs|gregorianUsFrench|… */
+    calendar?: string;
+    /** `<w:storeMappedDataAs w:val="…"/>` — storage format for data binding. */
+    storeMappedDataAs?: string;
+} | {
+    kind: "checkbox";
+    /** `<w14:checked w14:val="…"/>` — current boolean state (default false). */
+    checked?: boolean;
+    /** `<w14:checkedState w14:font="…" w14:char="…"/>` — checked-glyph spec. */
+    checkedStateFont?: string;
+    checkedStateChar?: string;
+    /** `<w14:uncheckedState w14:font="…" w14:char="…"/>` — unchecked-glyph spec. */
+    uncheckedStateFont?: string;
+    uncheckedStateChar?: string;
+} | {
+    kind: "repeatingSection";
+} | {
+    kind: "repeatingSectionItem";
+};
+/** Single item in a `<w:comboBox>` or `<w:dropDownList>`. */
+export interface EditorSdtListItem {
+    /** `<w:listItem w:displayText="…"/>` — what the user sees. */
+    displayText?: string;
+    /** `<w:listItem w:value="…"/>` — the stored value. */
+    value?: string;
+}
+/** `<w:dataBinding>` — XPath binding into a custom-XML storage part. */
+export interface EditorSdtDataBinding {
+    /** `<w:prefixMappings w:val="…"/>` — namespace prefixes for the XPath. */
+    prefixMappings?: string;
+    /** `<w:xpath w:val="…"/>` — the XPath expression selecting the bound node. */
+    xpath?: string;
+    /** `<w:storeItemID w:val="…"/>` — id of the `customXml/itemN.xml` part. */
+    storeItemID?: string;
+}
 export interface EditorParagraphNode {
     id: string;
     type: "paragraph";

package/dist/export/docx/text/sdtXml.d.ts

@@ -0,0 +1,10 @@
+import { EditorSdtPr } from '../../../core/model.js';
+
+/**
+ * `<w:sdtPr>` requires its subtype element to be the final named child per schema
+ * order, with `appearance`, `showingPlcHdr`, `color` trailing as extension-like
+ * properties. The exact ordering used by Word is: rPr, alias, tag, id, lock,
+ * placeholder, dataBinding, temporary, subtype, appearance, showingPlcHdr,
+ * color, extension. We mirror that so we round-trip as schema-valid.
+ */
+export declare function serializeSdtPrXml(sdtPr: EditorSdtPr): string;

package/dist/i18n/locales/en.d.ts

@@ -221,9 +221,13 @@ export declare const en: {
     "table.mergeTooltip": string;
     "table.split": string;
     "table.splitTooltip": string;
+    "table.insertLeft": string;
+    "table.insertRight": string;
     "table.insertColumnLeft": string;
     "table.insertColumnRight": string;
     "table.deleteColumn": string;
+    "table.insertAbove": string;
+    "table.insertBelow": string;
     "table.insertRowAbove": string;
     "table.insertRowBelow": string;
     "table.deleteRow": string;

package/dist/i18n/locales/pt-BR.d.ts

@@ -221,9 +221,13 @@ export declare const ptBR: {
     "table.mergeTooltip": string;
     "table.split": string;
     "table.splitTooltip": string;
+    "table.insertLeft": string;
+    "table.insertRight": string;
     "table.insertColumnLeft": string;
     "table.insertColumnRight": string;
     "table.deleteColumn": string;
+    "table.insertAbove": string;
+    "table.insertBelow": string;
     "table.insertRowAbove": string;
     "table.insertRowBelow": string;
     "table.deleteRow": string;

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

@@ -0,0 +1,9 @@
+import { Element as XmlElement } from '@xmldom/xmldom';
+import { EditorSdtPr } from '../../core/model.js';
+
+/**
+ * Parse a `<w:sdtPr>` element into the typed model. Returns `{}` (empty) when
+ * `sdtPr` is null or has no recognized children; the caller still attaches an
+ * empty wrapper so the round-trip emits an empty `<w:sdtPr/>`.
+ */
+export declare function parseSdtPr(sdtPr: XmlElement | null): EditorSdtPr;

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

@@ -1,7 +1,6 @@
 import { Element as XmlElement } from '@xmldom/xmldom';
-import { EditorParagraphNode, EditorTableCellStyle, EditorTableRowNode, EditorTableRowStyle, EditorTableStyle, EditorTableConditionalFlags } from '../../core/model.js';
+import { EditorTableCellStyle, EditorTableRowNode, EditorTableRowStyle, EditorTableStyle, EditorTableConditionalFlags } from '../../core/model.js';
 import { EditorTableBorders } from './borders.js';
-import { ParagraphAutospacingFlags } from './paragraphStyle.js';
 import { ThemeColorMap } from './themeColors.js';
 
 export declare function parseTableConditionalFlags(properties: XmlElement | null): EditorTableConditionalFlags | undefined;
@@ -18,16 +17,4 @@ export declare function getTableCellVMerge(cellProperties: XmlElement | null): "
 export declare function getTableCellHMerge(cellProperties: XmlElement | null): "restart" | "continue" | undefined;
 export declare function parseTableCellStyle(cellProperties: XmlElement | null, tableDefaultMargins?: EditorTableStyle["defaultCellMargins"], colors?: ThemeColorMap): EditorTableCellStyle | undefined;
 export declare function isTableHeaderRow(rowNode: XmlElement): boolean;
-/**
- * Reproduces Word's HTML-style margin collapsing for paragraphs that use "auto
- * spacing" (`w:beforeAutospacing` / `w:afterAutospacing`) inside a table cell.
- * Word ignores the literal before/after values for these margins and collapses
- * them: the first paragraph's auto before-space and the last paragraph's auto
- * after-space collapse to 0 against the cell edge, and two adjacent auto margins
- * collapse to their max instead of summing. Without this, oasis renders cells
- * taller than Word because every paragraph's spacing is summed in full.
- *
- * The flags array is parallel to `paragraphs` (one entry per `<w:p>` in the cell).
- */
-export declare function collapseCellAutospacing(paragraphs: EditorParagraphNode[], flags: ParagraphAutospacingFlags[]): void;
 export declare function applyTableBordersToRows(rows: EditorTableRowNode[], tblBorders: EditorTableBorders): void;