@silurus/ooxml 0.43.0 → 0.44.0

package/dist/types/docx.d.ts

@@ -124,7 +124,12 @@ export declare type DocRun = {
     type: 'field';
 } & FieldRun | {
     type: 'shape';
-} & ShapeRun;
+} & ShapeRun | {
+    type: 'math';
+    nodes: MathNode[];
+    display: boolean;
+    fontSize: number;
+};
 
 declare interface DocTable {
     colWidths: number[];
@@ -134,6 +139,8 @@ declare interface DocTable {
     cellMarginBottom: number;
     cellMarginLeft: number;
     cellMarginRight: number;
+    /** table horizontal alignment on the page: 'left' | 'center' | 'right'. */
+    jc: string;
 }
 
 declare interface DocTableCell {
@@ -379,6 +386,109 @@ declare interface LoadOptions_2 {
     useGoogleFonts?: boolean;
 }
 
+/** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
+declare interface MathAccent {
+    kind: 'accent';
+    char: string;
+    base: MathNode[];
+}
+
+/** Matrix (`m:m`) or aligned equation array (`m:eqArr`). rows → cells → nodes. */
+declare interface MathArray {
+    kind: 'array';
+    rows: MathNode[][][];
+    /** 'eq' = alternating right/left (eqArr); 'center' = matrix; 'left'. */
+    align: 'eq' | 'center' | 'left';
+}
+
+/** Over/under bar (`m:bar`). */
+declare interface MathBar {
+    kind: 'bar';
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+declare interface MathDelimiter {
+    kind: 'delimiter';
+    /** opening char (default '('). */
+    begChar: string;
+    /** closing char (default ')'). */
+    endChar: string;
+    /** separated groups (e.g. for cases / multiple args). */
+    items: MathNode[][];
+}
+
+declare interface MathFraction {
+    kind: 'fraction';
+    num: MathNode[];
+    den: MathNode[];
+    /** false = no rule (e.g. binomial); defaults to true. */
+    bar?: boolean;
+}
+
+declare interface MathFunc {
+    kind: 'func';
+    name: MathNode[];
+    arg: MathNode[];
+}
+
+declare interface MathGroup {
+    kind: 'group';
+    items: MathNode[];
+}
+
+/** Group character (`m:groupChr`), e.g. under/over brace. */
+declare interface MathGroupChr {
+    kind: 'groupChr';
+    char: string;
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+/** Lower/upper limit (`m:limLow` / `m:limUpp`), e.g. lim under n→∞. */
+declare interface MathLimit {
+    kind: 'limit';
+    base: MathNode[];
+    lower?: MathNode[];
+    upper?: MathNode[];
+}
+
+declare interface MathNary {
+    kind: 'nary';
+    /** operator char, e.g. '∑', '∫', '∏'. */
+    op: string;
+    /** limit location (`m:limLoc`): 'subSup' = beside the op, 'undOvr' = above/below.
+     *  Empty/omitted = default by operator class (integrals → subSup, others → undOvr). */
+    limLoc?: string;
+    sub?: MathNode[];
+    sup?: MathNode[];
+    body: MathNode[];
+}
+
+declare type MathNode = MathRun | MathFraction | MathScript | MathNary | MathDelimiter | MathRadical | MathLimit | MathArray | MathGroupChr | MathBar | MathAccent | MathFunc | MathGroup;
+
+declare interface MathRadical {
+    kind: 'radical';
+    /** optional index (e.g. cube root); empty/omitted = square root. */
+    index?: MathNode[];
+    radicand: MathNode[];
+}
+
+declare interface MathRun {
+    kind: 'run';
+    text: string;
+    style: MathStyle;
+}
+
+declare interface MathScript {
+    kind: 'sup' | 'sub' | 'subSup';
+    base: MathNode[];
+    sup?: MathNode[];
+    sub?: MathNode[];
+}
+
+declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
+
 declare interface NumberingInfo {
     numId: number;
     level: number;

package/dist/types/index.d.ts

@@ -705,7 +705,12 @@ declare type DocRun = {
     type: 'field';
 } & FieldRun | {
     type: 'shape';
-} & ShapeRun;
+} & ShapeRun | {
+    type: 'math';
+    nodes: MathNode[];
+    display: boolean;
+    fontSize: number;
+};
 
 declare interface DocTable {
     colWidths: number[];
@@ -715,6 +720,8 @@ declare interface DocTable {
     cellMarginBottom: number;
     cellMarginLeft: number;
     cellMarginRight: number;
+    /** table horizontal alignment on the page: 'left' | 'center' | 'right'. */
+    jc: string;
 }
 
 declare interface DocTableCell {
@@ -1150,6 +1157,109 @@ declare interface ManualLayout {
     h?: number;
 }
 
+/** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
+declare interface MathAccent {
+    kind: 'accent';
+    char: string;
+    base: MathNode[];
+}
+
+/** Matrix (`m:m`) or aligned equation array (`m:eqArr`). rows → cells → nodes. */
+declare interface MathArray {
+    kind: 'array';
+    rows: MathNode[][][];
+    /** 'eq' = alternating right/left (eqArr); 'center' = matrix; 'left'. */
+    align: 'eq' | 'center' | 'left';
+}
+
+/** Over/under bar (`m:bar`). */
+declare interface MathBar {
+    kind: 'bar';
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+declare interface MathDelimiter {
+    kind: 'delimiter';
+    /** opening char (default '('). */
+    begChar: string;
+    /** closing char (default ')'). */
+    endChar: string;
+    /** separated groups (e.g. for cases / multiple args). */
+    items: MathNode[][];
+}
+
+declare interface MathFraction {
+    kind: 'fraction';
+    num: MathNode[];
+    den: MathNode[];
+    /** false = no rule (e.g. binomial); defaults to true. */
+    bar?: boolean;
+}
+
+declare interface MathFunc {
+    kind: 'func';
+    name: MathNode[];
+    arg: MathNode[];
+}
+
+declare interface MathGroup {
+    kind: 'group';
+    items: MathNode[];
+}
+
+/** Group character (`m:groupChr`), e.g. under/over brace. */
+declare interface MathGroupChr {
+    kind: 'groupChr';
+    char: string;
+    pos: 'top' | 'bot';
+    base: MathNode[];
+}
+
+/** Lower/upper limit (`m:limLow` / `m:limUpp`), e.g. lim under n→∞. */
+declare interface MathLimit {
+    kind: 'limit';
+    base: MathNode[];
+    lower?: MathNode[];
+    upper?: MathNode[];
+}
+
+declare interface MathNary {
+    kind: 'nary';
+    /** operator char, e.g. '∑', '∫', '∏'. */
+    op: string;
+    /** limit location (`m:limLoc`): 'subSup' = beside the op, 'undOvr' = above/below.
+     *  Empty/omitted = default by operator class (integrals → subSup, others → undOvr). */
+    limLoc?: string;
+    sub?: MathNode[];
+    sup?: MathNode[];
+    body: MathNode[];
+}
+
+declare type MathNode = MathRun | MathFraction | MathScript | MathNary | MathDelimiter | MathRadical | MathLimit | MathArray | MathGroupChr | MathBar | MathAccent | MathFunc | MathGroup;
+
+declare interface MathRadical {
+    kind: 'radical';
+    /** optional index (e.g. cube root); empty/omitted = square root. */
+    index?: MathNode[];
+    radicand: MathNode[];
+}
+
+declare interface MathRun {
+    kind: 'run';
+    text: string;
+    style: MathStyle;
+}
+
+declare interface MathScript {
+    kind: 'sup' | 'sub' | 'subSup';
+    base: MathNode[];
+    sup?: MathNode[];
+    sub?: MathNode[];
+}
+
+declare type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
+
 declare interface MediaElement {
     type: 'media';
     x: number;