@univerjs/core 1.0.0-alpha.7 → 1.0.0-alpha.8

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

@@ -16,4 +16,4 @@
 export { BaseDataModel } from './base-data-model';
 export { createDefaultBaseTableSnapshot, getEmptySnapshot as getBasesEmptySnapshot, type ICreateDefaultBaseTableSnapshotOptions, } from './empty-snapshot';
 export { BaseFieldType, BaseFilterConjunction, BaseFilterOperator, BaseSortDirection, BaseViewType } from './typedef';
-export type { BaseCellMatrix, BaseCellPrimitiveValue, CellValue as BaseCellValue, BaseCellValueType, BaseHitTestResult, BaseId, PrimitiveCellValue as BasePrimitiveCellValue, BaseSelection, BaseSnapshot, BaseViewProjection, FieldConfig, FieldId, FieldSnapshot, IBaseCellData, IBaseInvalidation, IBaseRect, IBaseResources, IBaseSnapshot, IBaseViewColorCondition, IBaseViewport, ICalendarEventResizeSelection, ICalendarEventSelection, ICalendarProjection, ICalendarViewConfig, ICardLayoutConfig, IFieldCapabilities, IFieldSnapshot, IFilterCondition, IFilterConfig, IGalleryCardSelection, IGalleryProjection, IGalleryViewConfig, IGanttBarSelection, IGanttCellSelection, IGanttProjection, IGanttTimeColumn, IGanttViewConfig, IGridCellSelection, IGridFieldSelection, IGridGroupSelection, IGridProjection, IGridRecordSelection, IGridViewConfig, IGroupConfig, IInvalidViewProjection, IKanbanCardSelection, IKanbanColumnSetting, IKanbanFieldCardSetting, IKanbanProjection, IKanbanViewConfig, IProjectedField, IProjectedGroup, IProjectedRow, IRecordSnapshot, ISortConfig, ITableSnapshot, IValidationResult, IViewFieldSetting, IViewProjection, IViewSnapshot, KanbanCardLayoutMode, RecordId, RecordSnapshot, TableId, TableSnapshot, ViewId, ViewSnapshot, ViewSpecificConfig, } from './typedef';
+export type { BaseCellMatrix, BaseCellPrimitiveValue, CellValue as BaseCellValue, BaseCellValueType, BaseHitTestResult, BaseId, PrimitiveCellValue as BasePrimitiveCellValue, BaseSelection, BaseSnapshot, BaseViewProjection, FieldConfig, FieldId, FieldSnapshot, IBaseAttachment, IBaseCellData, IBaseInvalidation, IBaseRect, IBaseResources, IBaseSnapshot, IBaseViewColorCondition, IBaseViewport, ICalendarEventResizeSelection, ICalendarEventSelection, ICalendarProjection, ICalendarViewConfig, ICardLayoutConfig, IFieldCapabilities, IFieldSnapshot, IFilterCondition, IFilterConfig, IGalleryCardSelection, IGalleryProjection, IGalleryViewConfig, IGanttBarSelection, IGanttCellSelection, IGanttProjection, IGanttTimeColumn, IGanttViewConfig, IGridCellSelection, IGridFieldSelection, IGridGroupSelection, IGridProjection, IGridRecordSelection, IGridViewConfig, IGroupConfig, IInvalidViewProjection, IKanbanCardSelection, IKanbanColumnSetting, IKanbanFieldCardSetting, IKanbanProjection, IKanbanViewConfig, IProjectedField, IProjectedGroup, IProjectedRow, IRecordSnapshot, ISortConfig, ITableSnapshot, IValidationResult, IViewFieldSetting, IViewProjection, IViewSnapshot, KanbanCardLayoutMode, RecordId, RecordSnapshot, TableId, TableSnapshot, ViewId, ViewSnapshot, ViewSpecificConfig, } from './typedef';

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

@@ -13,6 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import type { ImageSourceType } from '../services/image-io/image-io.service';
+import type { IResources } from '../services/resource-manager/type';
 import type { CellValueType, LocaleType } from '../types/enum';
 import type { IDocumentData } from '../types/interfaces';
 export type BaseId = string;
@@ -38,6 +40,26 @@ export interface IBaseResources {
     attachmentSets?: Record<string, string[]>;
     attachments?: Record<string, Record<string, unknown>>;
 }
+export interface IBaseAttachment {
+    /** Stable attachment identifier. Use the uploaded file id for remote attachments. */
+    id: string;
+    /** Display name, including the file extension when available. */
+    name: string;
+    /** MIME type used to classify and preview the attachment. */
+    mimeType?: string;
+    /** File size in bytes. */
+    size?: number;
+    /** Image width in pixels when known. */
+    width?: number;
+    /** Image height in pixels when known. */
+    height?: number;
+    /** How to interpret `source`, for example UUID, URL, or Base64 data. */
+    sourceType?: ImageSourceType;
+    /** Canonical attachment source: an uploaded file id, URL, or Base64 data URL. */
+    source?: string;
+    /** Optional preview source when it is distinct from the canonical attachment source. */
+    thumbnail?: string;
+}
 export declare enum BaseFieldType {
     Text = "text",
     SingleSelect = "singleSelect",
@@ -90,6 +112,7 @@ export interface IBaseSnapshot {
     createdAt: number;
     updatedAt: number;
     createdBy?: string;
+    resources?: IResources;
 }
 export interface ITableSnapshot {
     id: TableId;

package/lib/types/docs/data-model/paragraph-style.d.ts

@@ -14,9 +14,15 @@
  * limitations under the License.
  */
 import type { Nullable } from '../../shared';
-import type { IDocumentStyle, IParagraphStyle } from '../../types/interfaces';
+import type { IDocStyles, IDocumentStyle, IParagraphStyle } from '../../types/interfaces';
 export interface IResolveDocumentParagraphStyleOptions {
+    /** Exclude document-level outer spacing while retaining all other defaults. */
     excludeDocumentOuterSpacing?: boolean;
+    /** Preserve the legacy Modern Doc spacing defaults when no explicit flavor is available. */
     useLegacyModernDefaults?: boolean;
+    /** Named document styles keyed by stable style id. */
+    styles?: IDocStyles;
+    /** Named paragraph style referenced by the paragraph. */
+    paragraphStyleId?: string;
 }
 export declare function resolveDocumentParagraphStyle(documentStyle: Nullable<IDocumentStyle>, paragraphStyle: Nullable<IParagraphStyle>, options?: IResolveDocumentParagraphStyleOptions): IParagraphStyle;

package/lib/types/docs/data-model/rich-text-builder.d.ts

@@ -32,7 +32,9 @@ export declare function normalizeData(data: IDocumentData): IDocumentData;
  * Agent-friendly text style aliases accepted by `RichTextBuilder.span()`.
  *
  * The readable aliases can be combined in one object and apply only to the appended span. Native `ITextStyle` fields
- * remain available for advanced document integrations.
+ * remain available for advanced document integrations. Drawing effects such as `glow` and `outerShadow` are
+ * especially useful when the resulting rich text is attached to a Shape; standalone document products may not expose
+ * dedicated controls for them.
  *
  * @example
  * ```ts
@@ -43,6 +45,14 @@ export declare function normalizeData(data: IDocumentData): IDocumentData;
  *     italic: true,
  *     color: '#dc2626',
  *     background: '#fee2e2',
+ *     glow: { color: '#f97316', radius: 6 },
+ *     outerShadow: {
+ *       color: '#000000',
+ *       opacity: 0.35,
+ *       blurRadius: 4,
+ *       distance: 3,
+ *       direction: 45,
+ *     },
  *   });
  * ```
  */

package/lib/types/docs/data-model/text-x/build-utils/index.d.ts

@@ -70,7 +70,7 @@ export declare class BuildTextUtils {
 export { getSingleDataStreamChange } from './data-stream-change';
 export type { IDataStreamChange } from './data-stream-change';
 export { getCustomBlockIdsInSelections } from './drawings';
-export { getParagraphContentStartOffset, getParagraphContentStartOffsets, getParagraphFollowingBlockOffset } from './paragraph';
+export { getParagraphContentStartOffset, getParagraphContentStartOffsets, getParagraphFollowingBlockOffset, } from './paragraph';
 export { containsInteriorInsertionOffset, containsStreamIndex, getBlockRangeInterval, getColumnGroupRangeInterval, getCustomBlockInterval, getCustomRangeInterval, getExclusiveRangeInterval, getInclusiveRangeInterval, getTableCellTokenInterval, getTableRangeInterval, getTableRowTokenInterval, intersectsOperationalIntervals, shiftExclusiveRangeOnDelete, shiftExclusiveRangeOnInsert, shiftInclusiveRangeOnDelete, shiftInclusiveRangeOnInsert, } from './range-interval';
 export type { IDocOperationalInterval } from './range-interval';
 export type { IAddCustomRangeTextXParam, IDeleteCustomRangeParam, IReplaceSelectionTextXParams } from './text-x-utils';

package/lib/types/docs/data-model/text-x/utils.d.ts

@@ -37,6 +37,7 @@ export declare function getColumnGroupSlice(body: IDocumentBody, startOffset: nu
 export declare function getParagraphsSlice(body: IDocumentBody, startOffset: number, endOffset: number, type?: SliceBodyType): {
     startIndex: number;
     paragraphId: string;
+    styleId?: string;
     paragraphStyle?: import("../../..").IParagraphStyle;
     bullet?: import("../../..").IBullet;
 }[] | undefined;

package/lib/types/docs/data-model/types.d.ts

@@ -55,5 +55,3 @@ export declare enum DataStreamTreeTokenType {
     LETTER = "",
     SPACE = " "
 }
-/** Wrap your stream in a pair of custom range tokens. */
-export declare function makeCustomRangeStream(stream: string): string;

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/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

@@ -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/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;
 }
@@ -565,15 +580,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
 }
 /**
@@ -638,6 +663,20 @@ export interface ITextStyle extends IStyleBase {
     pos?: number;
     sa?: number;
     textFill?: IDocTextFill;
+    /**
+     * 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;
@@ -672,9 +711,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;