@univerjs/core 1.0.0-alpha.7 → 1.0.0-beta.0

package/lib/types/facade/f-univer.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { CommandListener, IDisposable, IDocumentData, IExecutionOptions, ILanguagePack, IParagraphStyle, ITextDecoration, ITextStyle, LifecycleStages } from '@univerjs/core';
+import type { IDisposable, IDocumentData, IExecutionOptions, ILanguagePack, IParagraphStyle, ITextDecoration, ITextStyle, LifecycleStages } from '@univerjs/core';
 import type { Subscription } from 'rxjs';
 import type { IEventParamConfig } from './f-event';
 import { Disposable, ICommandService, Injector, IUniverInstanceService, LifecycleService, ParagraphStyleBuilder, ParagraphStyleValue, RichTextBuilder, RichTextValue, TextDecorationBuilder, TextStyleBuilder, TextStyleValue, Univer } from '@univerjs/core';
@@ -21,7 +21,6 @@ import { FBlob } from './f-blob';
 import { FEnum } from './f-enum';
 import { FEventName } from './f-event';
 import { FEventRegistry } from './f-event-registry';
-import { FHooks } from './f-hooks';
 import { FUserManager } from './f-usermanager';
 import { FUtil } from './f-util';
 /**
@@ -164,20 +163,6 @@ export declare class FUniver extends Disposable {
      * ```
      */
     getLocales(): ILanguagePack | undefined;
-    /**
-     * Register a callback that will be triggered before invoking a command.
-     * @deprecated use `univerAPI.addEvent(univerAPI.Event.BeforeCommandExecute, (event) => {})` instead.
-     * @param {CommandListener} callback The callback.
-     * @returns {IDisposable} The disposable instance.
-     */
-    onBeforeCommandExecute(callback: CommandListener): IDisposable;
-    /**
-     * Register a callback that will be triggered when a command is invoked.
-     * @deprecated use `univerAPI.addEvent(univerAPI.Event.CommandExecuted, (event) => {})` instead.
-     * @param {CommandListener} callback The callback.
-     * @returns {IDisposable} The disposable instance.
-     */
-    onCommandExecuted(callback: CommandListener): IDisposable;
     /**
      * Execute a command with the given id and parameters.
      * @param id Identifier of the command.
@@ -210,12 +195,6 @@ export declare class FUniver extends Disposable {
      * ```
      */
     syncExecuteCommand<P extends object = object, R = boolean>(id: string, params?: P, options?: IExecutionOptions): R;
-    /**
-     * Get hooks.
-     * @deprecated use `addEvent` instead.
-     * @returns {FHooks} FHooks instance
-     */
-    getHooks(): FHooks;
     get Enum(): FEnum;
     get Event(): FEventName;
     get Util(): FUtil;

package/lib/types/facade/index.d.ts

@@ -17,6 +17,5 @@ export { FBase, FBaseInitialable } from './f-base';
 export { FBlob, type IFBlobSource } from './f-blob';
 export { FEnum } from './f-enum';
 export { FEventName, type IEventBase, type IEventParamConfig } from './f-event';
-export { FHooks } from './f-hooks';
 export { FUniver } from './f-univer';
 export { FUtil } from './f-util';

package/lib/types/services/context/context.d.ts

@@ -18,8 +18,6 @@ export declare const FOCUSING_SHEET = "FOCUSING_SHEET";
 export declare const FOCUSING_DOC = "FOCUSING_DOC";
 export declare const FOCUSING_SLIDE = "FOCUSING_SLIDE";
 export declare const FOCUSING_BOARD = "FOCUSING_BOARD";
-/** @deprecated */
-export declare const FOCUSING_EDITOR_BUT_HIDDEN = "FOCUSING_EDITOR_BUT_HIDDEN";
 export declare const EDITOR_ACTIVATED = "EDITOR_ACTIVATED";
 export declare const FOCUSING_EDITOR_INPUT_FORMULA = "FOCUSING_EDITOR_INPUT_FORMULA";
 /** The focusing state of the formula editor (Fx bar). */

package/lib/types/services/instance/instance.service.d.ts

@@ -19,9 +19,7 @@ import type { UnitModel } from '../../common/unit';
 import type { Nullable } from '../../shared';
 import { Injector } from '../../common/di';
 import { UniverInstanceType } from '../../common/unit';
-import { DocumentDataModel } from '../../docs/data-model/document-data-model';
 import { Disposable } from '../../shared/lifecycle';
-import { Workbook } from '../../sheets/workbook';
 import { IContextService } from '../context/context.service';
 import { ILogService } from '../log/log.service';
 export type UnitCtor = new (...args: any[]) => UnitModel;
@@ -98,13 +96,9 @@ export interface IUniverInstanceService {
     /** Dispose a unit  */
     disposeUnit(unitId: string): boolean;
     registerCtorForType<T extends UnitModel>(type: UniverInstanceType, ctor: new (...args: any[]) => T): IDisposable;
-    /** @deprecated */
-    changeDoc(unitId: string, doc: DocumentDataModel): void;
     getUnit<T extends UnitModel>(id: string, type?: UniverInstanceType): Nullable<T>;
     getAllUnitsForType<T>(type: UniverInstanceType): T[];
     getUnitType(unitId: string): UniverInstanceType;
-    /** @deprecated */
-    getUniverSheetInstance(unitId: string): Nullable<Workbook>;
 }
 export declare const IUniverInstanceService: import("@wendellhu/redi").IdentifierDecorator<IUniverInstanceService>;
 export declare class UniverInstanceService extends Disposable implements IUniverInstanceService {
@@ -143,9 +137,7 @@ export declare class UniverInstanceService extends Disposable implements IUniver
     getTypeOfUnitDisposed$<T extends UnitModel<object, number>>(type: UniverInstanceType): Observable<T>;
     getUnit<T extends UnitModel = UnitModel>(id: string, type?: UniverInstanceType): Nullable<T>;
     getUnitCreateOptions(unitId: string): Nullable<ICreateUnitOptions>;
-    getUniverSheetInstance(unitId: string): Nullable<Workbook>;
     getAllUnitsForType<T>(type: UniverInstanceType): T[];
-    changeDoc(unitId: string, doc: DocumentDataModel): void;
     private readonly _focused$;
     readonly focused$: Observable<Nullable<string>>;
     get focused(): Nullable<UnitModel>;

package/lib/types/shared/cache/image-cache.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { Injector } from '@wendellhu/redi';
+import type { Injector } from '../../common/di';
 import { ImageSourceType } from '../../services/image-io/image-io.service';
 export declare class ImageCacheMap {
     private _injector;

package/lib/types/shared/common.d.ts

@@ -25,11 +25,6 @@ import type { Nullable } from './types';
  * @returns IRangeWithCoord
  */
 export declare function convertCellToRange(cellInfo: ICellWithCoord): IRangeWithCoord;
-/**
- * @deprecated use `convertCellToRange` instead
- */
-declare const makeCellToSelection: typeof convertCellToRange;
-export { makeCellToSelection };
 export declare function makeCellRangeToRangeData(cellInfo: Nullable<ISelectionCell>): Nullable<IRange>;
 export declare function isEmptyCell(cell: Nullable<ICellData>): boolean;
 export declare function isCellCoverable(cell: Nullable<ICellDataForSheetInterceptor>): boolean;

package/lib/types/shared/object-matrix.d.ts

@@ -54,12 +54,6 @@ export declare class ObjectMatrix<T> {
     hasValue(): boolean;
     getValue(row: number, column: number): Nullable<T>;
     setValue(row: number, column: number, value: T): void;
-    /**
-     * ！！
-     * Please +1 ‘！’, who fell into this pit.
-     * @deprecated use `realDelete` or `splice`
-     */
-    deleteValue(row: number, column: number): void;
     realDeleteValue(row: number, column: number): void;
     setRow(rowNumber: number, row: IObjectArrayPrimitiveType<T>): void;
     moveRows(start: number, count: number, target: number): void;
@@ -106,15 +100,7 @@ export declare class ObjectMatrix<T> {
     toNativeArray(): T[];
     toArray(): T[][];
     toFullArray(): T[][];
-    /**
-     * @deprecated Use getMatrix as a substitute.
-     */
-    toJSON(): IObjectMatrixPrimitiveType<T>;
     clone(): IObjectMatrixPrimitiveType<T>;
-    /**
-     * @deprecated Use clone as a substitute.
-     */
-    getData(): IObjectMatrixPrimitiveType<T>;
     getArrayData(): IObjectMatrixPrimitiveType<T>;
     /**
      * the function can only be used in all the row and column are positive integer

package/lib/types/shared/rectangle.d.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 import type { IRange, IRectLTRB } from '../sheets/typedef';
-import type { Nullable } from './types';
 /**
  * This class provides a set of methods to calculate and manipulate rectangular ranges (IRange).
  * A range represents a rectangular area in a grid, defined by start/end rows and columns.
@@ -106,20 +105,6 @@ export declare class Rectangle {
      * ```
      */
     static doAnyRangesIntersect(src: IRange[], target: IRange[]): boolean;
-    /**
-     * Gets the intersection range between two ranges
-     * @param src
-     * @param target
-     * @deprecated use `getIntersectRange` instead
-     * @example
-     * ```typescript
-     * const range1 = { startRow: 0, startColumn: 0, endRow: 2, endColumn: 2 };
-     * const range2 = { startRow: 1, startColumn: 1, endRow: 3, endColumn: 3 };
-     * const intersection = Rectangle.getIntersects(range1, range2);
-     * // intersection = { startRow: 1, startColumn: 1, endRow: 2, endColumn: 2 }
-     * ```
-     */
-    static getIntersects(src: IRange, target: IRange): Nullable<IRange>;
     /**
      * Checks if one range completely contains another range
      * @param src

package/lib/types/shared/tools.d.ts

@@ -22,8 +22,6 @@ export declare class Tools {
     static deleteNull(obj: any): any;
     static getSystemType(): string;
     static getBrowserType(): string;
-    /** @deprecated This method is deprecated, please use `import { merge } from '@univerjs/core` instead */
-    static deepMerge(target: any, ...sources: any[]): any;
     static diffValue(one: any, two: any): boolean;
     static deepClone<T = unknown>(value: T): T;
     static getValueType(value: any): string;

package/lib/types/sheets/sheet-skeleton.d.ts

@@ -18,7 +18,7 @@ import type { IDocumentData, IDocumentRenderConfig, IPaddingData } from '../type
 import type { Styles } from './styles';
 import type { ICellData, ICellInfo, ICellWithCoord, IPosition, IRange, ISelectionCell, IWorksheetData } from './typedef';
 import type { Worksheet } from './worksheet';
-import { Injector } from '@wendellhu/redi';
+import { Injector } from '../common/di';
 import { DocumentDataModel } from '../docs/data-model/document-data-model';
 import { IConfigService } from '../services/config/config.service';
 import { IContextService } from '../services/context/context.service';
@@ -81,8 +81,8 @@ export declare class SheetSkeleton extends Skeleton {
     protected readonly _configService: IConfigService;
     protected _injector: Injector;
     /**
-     * @deprecated avoid use `IWorksheetData` directly, use API provided by `Worksheet`, otherwise
-     * `ViewModel` will be not working.
+     * Avoid using `IWorksheetData` directly when an API is provided by `Worksheet`, otherwise
+     * `ViewModel` will not work.
      */
     protected _worksheetData: IWorksheetData;
     protected _renderRawFormula: boolean;
@@ -95,10 +95,6 @@ export declare class SheetSkeleton extends Skeleton {
     constructor(worksheet: Worksheet, _styles: Styles, _localeService: LocaleService, _contextService: IContextService, _configService: IConfigService, _injector: Injector);
     initConfig(): void;
     resetCache(): void;
-    /**
-     * @deprecated should never expose a property that is provided by another module!
-     */
-    getWorksheetConfig(): IWorksheetData;
     /**
      * Get which Workbook and Worksheet this skeleton is attached to.
      * @returns [unitId, sheetId]

package/lib/types/sheets/typedef.d.ts

@@ -97,11 +97,8 @@ export interface IWorksheetData {
     freeze: IFreeze;
     rowCount: number;
     columnCount: number;
-    /** @deprecated */
     zoomRatio: number;
-    /** @deprecated */
     scrollTop: number;
-    /** @deprecated */
     scrollLeft: number;
     defaultColumnWidth: number;
     defaultRowHeight: number;
@@ -486,12 +483,6 @@ export interface ISingleCell {
 }
 export interface IRangeWithCoord extends IPosition, IRange {
 }
-/**
- * @deprecated use ICellWithCoord instead.
- */
-export interface ISelectionCellWithMergeInfo extends IPosition, ISingleCell {
-    mergeInfo: IRangeWithCoord;
-}
 /**
  * SingleCell & coordinate and mergeRange.
  */
@@ -586,11 +577,6 @@ export interface ITextRangeParam extends ITextRange {
     isActive?: boolean;
     rangeType?: DOC_RANGE_TYPE;
 }
-/**
- * Determines whether the cell(row, column) is within the range of the merged cells.
- * @deprecated please use worksheet.getCellInfoInMergeData instead
- */
-export declare function getCellInfoInMergeData(row: number, column: number, mergeData?: IRange[]): ISelectionCell;
 export type ICellDataWithSpanAndDisplay = ICellData & {
     rowSpan?: number;
     colSpan?: number;

package/lib/types/sheets/workbook.d.ts

@@ -71,8 +71,6 @@ export declare class Workbook extends UnitModel<IWorkbookData, UniverInstanceTyp
      * @memberof Workbook
      */
     getSnapshot(): IWorkbookData;
-    /** @deprecated use use name property instead */
-    getName(): string;
     setName(name: string): void;
     getUnitId(): string;
     getRev(): number;

package/lib/types/sheets/worksheet.d.ts

@@ -192,12 +192,6 @@ export declare class Worksheet {
      * @returns name of the sheet
      */
     getName(): string;
-    /**
-     * Returns WorkSheet Clone Object
-     * @returns WorkSheet Clone Object
-     * @deprecated
-     */
-    clone(): Worksheet;
     /**
      * Get the merged cell list of the sheet.
      * @returns {IRange[]} merged cell list

package/lib/types/types/const/page-size.d.ts

@@ -23,3 +23,5 @@ export declare enum ModernDocumentWidthMode {
 }
 export declare const MODERN_DOCUMENT_WIDTH: Record<ModernDocumentWidthMode, number>;
 export declare const MODERN_DOCUMENT_DEFAULT_MARGIN: number;
+/** Default margin for a paginated Traditional document, in 96-DPI layout pixels. */
+export declare const TRADITIONAL_DOCUMENT_DEFAULT_MARGIN = 72;

package/lib/types/types/enum/text-style.d.ts

@@ -42,7 +42,9 @@ export declare enum TextDecoration {
     WAVE = 14,
     WAVY_DOUBLE = 15,
     WAVY_HEAVY = 16,
-    WORDS = 17
+    WORDS = 17,
+    SINGLE_ACCOUNTING = 18,
+    DOUBLE_ACCOUNTING = 19
 }
 /**
  * An enum that specifies the horizontal alignment of text.

package/lib/types/types/enum/theme-color-type.d.ts

@@ -15,8 +15,6 @@
  */
 /**
  * Theme color type enum
- *
- * @deprecated
  */
 export declare enum ThemeColorType {
     /**
@@ -43,8 +41,6 @@ export declare enum ThemeColorType {
 }
 /**
  * Preset theme names.
- *
- * @deprecated
  */
 export declare enum ThemeColors {
     OFFICE = "Office",

package/lib/types/types/interfaces/i-cell-custom-render.d.ts

@@ -32,8 +32,6 @@ export interface ICellRenderContext {
 /**
  * @debt This shouldn't exist in core package.
  * @ignore
- *
- * @deprecated This interface is subject to change in the future.
  */
 export interface ICellCustomRender {
     drawWith(ctx: CanvasRenderingContext2D, info: ICellRenderContext, skeleton: any, spreadsheets: any): void;

package/lib/types/types/interfaces/i-document-data.d.ts

@@ -19,7 +19,7 @@ import type { ISize } from '../../shared/shape';
 import type { BooleanNumber, CellValueType, HorizontalAlign, LocaleType, TextDirection, VerticalAlign, WrapStrategy } from '../enum';
 import type { IDrawingParam } from './i-drawing';
 import type { IMention } from './i-mention';
-import type { IColorStyle, IStyleBase } from './i-style-data';
+import type { IColorStyle, IGlowEffect, IShadowEffect, IStyleBase } from './i-style-data';
 /**
  * Properties of document
  */
@@ -32,6 +32,8 @@ export interface IDocumentData extends IReferenceSource {
     title?: string;
     body?: IDocumentBody;
     documentStyle: IDocumentStyle;
+    /** OOXML-compatible named document styles keyed by stable style id. */
+    styles?: IDocStyles;
     settings?: IDocumentSettings;
     resources?: IResources;
     disabled?: boolean;
@@ -137,10 +139,11 @@ export declare enum DocumentBlockType {
 }
 export interface IDocStyle {
     name: string;
-    basedOn: string;
-    link: string;
+    basedOn?: string;
+    link?: string;
     type: DocStyleType;
-    textStyle: ITextStyle;
+    textStyle?: ITextStyle;
+    paragraphStyle?: IParagraphStyle;
 }
 export declare enum DocStyleType {
     character = 0,
@@ -270,9 +273,13 @@ export declare enum BulletAlignment {
     BOTH = 4
 }
 export interface IMargin {
+    /** Top page margin in 96-DPI layout pixels. */
     marginTop?: number;
+    /** Bottom page margin in 96-DPI layout pixels. */
     marginBottom?: number;
+    /** Right page margin in 96-DPI layout pixels. */
     marginRight?: number;
+    /** Left page margin in 96-DPI layout pixels. */
     marginLeft?: number;
 }
 export interface ITableOfContent {
@@ -341,6 +348,10 @@ export declare enum CustomRangeType {
     UNI_FORMULA = 7,
     DELTED = 9999
 }
+export declare enum DocxBreakType {
+    COLUMN = "column",
+    TEXT_WRAPPING = "textWrapping"
+}
 /**
  * Custom Block
  */
@@ -389,12 +400,13 @@ export declare enum DocumentFlavor {
  */
 export interface IDocStyleBase extends IMargin {
     pageNumberStart?: number;
+    /** Page size in 96-DPI layout pixels. */
     pageSize?: ISize;
     pageOrient?: PageOrientType;
     documentFlavor?: DocumentFlavor;
-    /** Distance from the page edge to the header, in points (pt). */
+    /** Distance from the page edge to the header, in 96-DPI layout pixels. */
     marginHeader?: number;
-    /** Distance from the page edge to the footer, in points (pt). */
+    /** Distance from the page edge to the footer, in 96-DPI layout pixels. */
     marginFooter?: number;
     renderConfig?: IDocumentRenderConfig;
 }
@@ -474,9 +486,10 @@ export interface ISectionBreak extends IDocStyleBase, ISectionBreakBase, IHeader
 export declare enum SectionType {
     SECTION_TYPE_UNSPECIFIED = 0,// The section type is unspecified.
     CONTINUOUS = 1,// The section starts immediately after the last paragraph of the previous section.
-    NEXT_PAGE = 2,// The section starts on the next page.
-    EVEN_PAGE = 3,// The section starts on the next page.
-    ODD_PAGE = 4
+    NEXT_COLUMN = 2,// The section starts in the next column, or on the next page when no column remains.
+    NEXT_PAGE = 3,// The section starts on the next page.
+    EVEN_PAGE = 4,// The section starts on the next even-numbered page.
+    ODD_PAGE = 5
 }
 /**
  * The style of column separators between columns.
@@ -498,14 +511,16 @@ export declare enum TextDirectionType {
  * Properties of section column
  */
 export interface ISectionColumnProperties {
-    /** Column width in points (pt). */
+    /** Column width in 96-DPI layout pixels. */
     width: number;
-    /** Trailing space after the column in points (pt). */
+    /** Trailing space after the column in 96-DPI layout pixels. */
     paddingEnd: number;
 }
 export interface IParagraph {
     startIndex: number;
     paragraphId: string;
+    /** Optional stable named-style reference. Direct paragraph style has higher precedence. */
+    styleId?: string;
     paragraphStyle?: IParagraphStyle;
     bullet?: IBullet;
 }
@@ -528,6 +543,10 @@ export interface IBullet {
     listType: string;
     listId: string;
     nestingLevel: number;
+    startNumber?: number;
+    image?: {
+        source: string;
+    };
     textStyle?: ITextStyle;
 }
 /**
@@ -565,15 +584,25 @@ export declare enum WrapTextType {
     LARGEST = 3
 }
 /**
- * The possible layouts of a [PositionedObject]
+ * Controls how a positioned object participates in document text layout.
+ *
+ * `WRAP_NONE` does not by itself determine whether the object is in front of or behind text. Drawing data uses
+ * `behindDoc` for that stacking choice.
  */
 export declare enum PositionedObjectLayoutType {
+    /** Places the object in the text flow like a character and lets it affect the containing line's metrics. */
     INLINE = 0,
+    /** Floats the object without reflowing text. The object and text can overlap. */
     WRAP_NONE = 1,
+    /** Floats the object and wraps text around the custom polygon defined by its wrap path. */
     WRAP_POLYGON = 2,
+    /** Floats the object and wraps text around its rectangular bounds. */
     WRAP_SQUARE = 3,
+    /** Floats the object and allows text to flow through eligible open regions in its wrap contour. */
     WRAP_THROUGH = 4,
+    /** Floats the object and wraps text closely around its contour instead of its rectangular bounds. */
     WRAP_TIGHT = 5,
+    /** Floats the object in a horizontal band, leaving text only above and below it. */
     WRAP_TOP_AND_BOTTOM = 6
 }
 /**
@@ -633,11 +662,30 @@ export interface IDocTextFill {
         offsetY?: number;
     };
 }
+export interface IDocTextOutline {
+    color?: string;
+    width?: number;
+}
 export interface ITextStyle extends IStyleBase {
     sc?: number;
     pos?: number;
     sa?: number;
     textFill?: IDocTextFill;
+    textOutline?: IDocTextOutline;
+    /**
+     * DrawingML-style glow around the rendered glyphs.
+     *
+     * This is primarily intended for embedded rich text such as Shape text. A standalone document product may
+     * preserve and render the value without exposing dedicated authoring controls.
+     */
+    glow?: IGlowEffect;
+    /**
+     * DrawingML-style outer shadow around the rendered glyphs.
+     *
+     * This is primarily intended for embedded rich text such as Shape text. A standalone document product may
+     * preserve and render the value without exposing dedicated authoring controls.
+     */
+    outerShadow?: IShadowEffect;
 }
 export interface IIndentStart {
     indentFirstLine?: INumberUnit;
@@ -646,6 +694,11 @@ export interface IIndentStart {
     tabStops?: ITabStop[];
     indentEnd?: INumberUnit;
 }
+/**
+ * Vertical alignment of text runs inside a paragraph line box.
+ * This is the normalized form of DrawingML `fontAlgn`.
+ */
+export type ParagraphFontAlign = 'auto' | 'top' | 'center' | 'baseline' | 'bottom';
 /**
  * Properties of paragraph style
  */
@@ -660,6 +713,12 @@ export type IDocumentDefaultParagraphStyle = Omit<IParagraphStyle, 'headingId' |
 export interface IParagraphProperties extends IIndentStart {
     headingId?: string;
     namedStyleType?: NamedStyleType;
+    defaultTabStop?: number;
+    /** Whether East Asian kinsoku line-breaking rules apply to this paragraph. */
+    eastAsianLineBreak?: BooleanNumber;
+    /** Whether punctuation may hang outside the paragraph text bounds. */
+    hangingPunctuation?: BooleanNumber;
+    fontAlign?: ParagraphFontAlign;
     horizontalAlign?: HorizontalAlign;
     lineSpacing?: number;
     direction?: TextDirection;
@@ -672,9 +731,51 @@ export interface IParagraphProperties extends IIndentStart {
     borderBottom?: IParagraphBorder;
     borderLeft?: IParagraphBorder;
     borderRight?: IParagraphBorder;
+    /**
+     * Keeps all measured lines of this paragraph on one physical page when they fit.
+     *
+     * `undefined` inherits, `TRUE` enables, and an explicit `FALSE` disables an
+     * inherited value. An oversized paragraph still splits after starting on a
+     * fresh page. This Word-compatible pagination rule is rendered only by
+     * Traditional Docs.
+     *
+     * OOXML: 17.3.1.14 `keepLines`.
+     */
     keepLines?: BooleanNumber;
+    /**
+     * Keeps this paragraph with the following paragraph when they fit together.
+     *
+     * Consecutive `TRUE` values form a bounded keep chain. Set the final
+     * paragraph to `FALSE` when it must terminate an inherited or authored chain.
+     * `undefined` inherits. This Word-compatible pagination rule is rendered only
+     * by Traditional Docs.
+     *
+     * OOXML: 17.3.1.15 `keepNext`.
+     */
     keepNext?: BooleanNumber;
+    /**
+     * Starts this paragraph on the next physical page unless it is already at a
+     * page boundary.
+     *
+     * `undefined` inherits, `TRUE` enables, and an explicit `FALSE` disables an
+     * inherited value. Use a Section Break instead when the following content
+     * also needs different page geometry, columns, headers, or footers. This
+     * Word-compatible pagination rule is rendered only by Traditional Docs.
+     *
+     * OOXML: 17.3.1.23 `pageBreakBefore`.
+     */
+    pageBreakBefore?: BooleanNumber;
     wordWrap?: BooleanNumber;
+    /**
+     * Avoids leaving a single measured first or last line on a separate page
+     * when the paragraph can be adjusted without violating stronger keep rules.
+     *
+     * `undefined` inherits, `TRUE` enables, and an explicit `FALSE` disables an
+     * inherited value. This Word-compatible pagination rule is rendered only by
+     * Traditional Docs.
+     *
+     * OOXML: 17.3.1.44 `widowControl`.
+     */
     widowControl?: BooleanNumber;
     shading?: IShading;
     suppressHyphenation?: BooleanNumber;

package/lib/types/types/interfaces/i-need-check-disposable.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IDisposable } from '@wendellhu/redi';
+import type { IDisposable } from '../../common/di';
 export interface INeedCheckDisposable extends IDisposable {
     canDispose: () => boolean;
 }

package/lib/types/types/interfaces/i-style-data.d.ts

@@ -76,6 +76,49 @@ export interface IColor {
     b: number;
     a?: number;
 }
+/**
+ * Glow applied around drawing content.
+ *
+ * Dimensional values use the owning unit's drawing coordinate system.
+ */
+export interface IGlowEffect {
+    /** Glow color as a CSS color string. */
+    color: string;
+    /** Glow radius. */
+    radius?: number;
+}
+export type OuterShadowAlignment = 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
+/**
+ * Outer shadow applied to drawing content.
+ *
+ * Dimensional values use the owning unit's drawing coordinate system.
+ */
+export interface IShadowEffect {
+    /** Shadow color as a CSS color string. */
+    color: string;
+    /** OOXML preset shadow token, when the effect originated from `prstShdw`. */
+    preset?: string;
+    /** Shadow opacity, from 0 (transparent) to 1 (opaque). */
+    opacity?: number;
+    /** Blur radius. */
+    blurRadius?: number;
+    /** Direction in degrees, with 0 pointing right and 90 pointing down. */
+    direction?: number;
+    /** Offset distance from the source. */
+    distance?: number;
+    /** Horizontal scale factor; 1 means 100%. */
+    sx?: number;
+    /** Vertical scale factor; 1 means 100%. */
+    sy?: number;
+    /** Horizontal skew angle in degrees. */
+    skewX?: number;
+    /** Vertical skew angle in degrees. */
+    skewY?: number;
+    /** Alignment point used while scaling or skewing the shadow. */
+    alignment?: OuterShadowAlignment;
+    /** Whether the shadow rotates together with its source. */
+    rotateWithShape?: boolean;
+}
 /**
  * Style properties of border
  */