@univerjs/core 0.17.0 → 0.18.0

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

@@ -1,13 +1,29 @@
-import { Nullable, ObjectMatrix } from '../shared';
-import { IDocumentData, IDocumentRenderConfig, IPaddingData } from '../types/interfaces';
-import { Styles } from './styles';
-import { ICellData, ICellInfo, ICellWithCoord, IPosition, IRange, ISelectionCell, IWorksheetData } from './typedef';
-import { Worksheet } from './worksheet';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Nullable } from '../shared';
+import type { IDocumentData, IDocumentRenderConfig, IPaddingData } from '../types/interfaces';
+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 { DocumentDataModel } from '../docs/data-model/document-data-model';
 import { IConfigService } from '../services/config/config.service';
 import { IContextService } from '../services/context/context.service';
 import { LocaleService } from '../services/locale/locale.service';
+import { ObjectMatrix } from '../shared';
 import { ImageCacheMap } from '../shared/cache/image-cache';
 import { Skeleton } from '../skeleton';
 import { HorizontalAlign } from '../types/enum';

package/lib/types/sheets/sheet-snapshot-utils.d.ts

@@ -1,4 +1,19 @@
-import { IWorksheetData } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IWorksheetData } from './typedef';
 export declare const DEFAULT_WORKSHEET_ROW_COUNT_KEY = "DEFAULT_WORKSHEET_ROW_COUNT";
 export declare const DEFAULT_WORKSHEET_ROW_COUNT = 1000;
 export declare const DEFAULT_WORKSHEET_COLUMN_COUNT_KEY = "DEFAULT_WORKSHEET_COLUMN_COUNT";

package/lib/types/sheets/span-model.d.ts

@@ -1,4 +1,19 @@
-import { IRange } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IRange } from './typedef';
 import { Disposable } from '../shared/lifecycle';
 export declare class SpanModel extends Disposable {
     /**

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

@@ -1,6 +1,21 @@
-import { IKeyType, Nullable } from '../shared';
-import { IStyleData } from '../types/interfaces';
-import { ICellDataForSheetInterceptor } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IKeyType, Nullable } from '../shared';
+import type { IStyleData } from '../types/interfaces';
+import type { ICellDataForSheetInterceptor } from './typedef';
 /**
  * Styles in a workbook, cells locate styles based on style IDs
  *

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

@@ -1,10 +1,26 @@
-import { IResources } from '../services/resource-manager/type';
-import { IObjectArrayPrimitiveType, IObjectMatrixPrimitiveType, Nullable } from '../shared';
-import { BooleanNumber, CellValueType } from '../types/enum';
-import { LocaleType } from '../types/enum/locale-type';
-import { IDocumentData } from '../types/interfaces';
-import { ICellCustomRender } from '../types/interfaces/i-cell-custom-render';
-import { IStyleData } from '../types/interfaces/i-style-data';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IResources } from '../services/resource-manager/type';
+import type { IObjectArrayPrimitiveType, IObjectMatrixPrimitiveType, Nullable } from '../shared';
+import type { BooleanNumber } from '../types/enum';
+import type { LocaleType } from '../types/enum/locale-type';
+import type { IDocumentData } from '../types/interfaces';
+import type { ICellCustomRender } from '../types/interfaces/i-cell-custom-render';
+import type { IStyleData } from '../types/interfaces/i-style-data';
+import { CellValueType } from '../types/enum';
 /**
  * Snapshot of a workbook.
  */

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

@@ -1,8 +1,24 @@
-import { Nullable } from '../shared';
-import { CellValueType, TextDirection, HorizontalAlign, VerticalAlign, WrapStrategy } from '../types/enum';
-import { IPaddingData, IStyleBase, IStyleData, ITextRotation, ITextStyle } from '../types/interfaces';
-import { ICellData, IRange, IUnitRange } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Nullable } from '../shared';
+import type { CellValueType, TextDirection } from '../types/enum';
+import type { IPaddingData, IStyleBase, IStyleData, ITextRotation, ITextStyle } from '../types/interfaces';
+import type { ICellData, IRange, IUnitRange } from './typedef';
 import { DocumentDataModel } from '../docs';
+import { HorizontalAlign, VerticalAlign, WrapStrategy } from '../types/enum';
 export interface IFontLocale {
     fontList: string[];
     defaultFontSize: number;

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

@@ -1,7 +1,22 @@
-import { Observable } from 'rxjs';
-import { Nullable } from '../shared';
-import { IStyleData } from '../types/interfaces';
-import { CustomData, IRangeType, IWorkbookData, IWorksheetData } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Observable } from 'rxjs';
+import type { Nullable } from '../shared';
+import type { IStyleData } from '../types/interfaces';
+import type { CustomData, IRangeType, IWorkbookData, IWorksheetData } from './typedef';
 import { UnitModel, UniverInstanceType } from '../common/unit';
 import { ILogService } from '../services/log/log.service';
 import { Styles } from './styles';

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

@@ -1,14 +1,32 @@
-import { IInterceptor } from '../common/interceptor';
-import { Nullable, ObjectMatrix } from '../shared';
-import { BooleanNumber, HorizontalAlign, TextDirection, VerticalAlign, WrapStrategy, CellValueType } from '../types/enum';
-import { IPaddingData, IStyleData, ITextRotation } from '../types/interfaces';
-import { Styles } from './styles';
-import { CustomData, ICellData, ICellDataForSheetInterceptor, ICellDataWithSpanAndDisplay, IFreeze, IRange, ISelectionCell, IWorksheetData, CellModeEnum } from './typedef';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IInterceptor } from '../common/interceptor';
+import type { Nullable } from '../shared';
+import type { BooleanNumber, HorizontalAlign, TextDirection, VerticalAlign, WrapStrategy } from '../types/enum';
+import type { IPaddingData, IStyleData, ITextRotation } from '../types/interfaces';
+import type { Styles } from './styles';
+import type { CustomData, ICellData, ICellDataForSheetInterceptor, ICellDataWithSpanAndDisplay, IFreeze, IRange, ISelectionCell, IWorksheetData } from './typedef';
 import { DocumentDataModel } from '../docs';
+import { ObjectMatrix } from '../shared';
+import { CellValueType } from '../types/enum';
 import { ColumnManager } from './column-manager';
 import { Range } from './range';
 import { RowManager } from './row-manager';
 import { SpanModel } from './span-model';
+import { CellModeEnum } from './typedef';
 import { SheetViewModel } from './view-model';
 export interface IDocumentLayoutObject {
     documentModel: Nullable<DocumentDataModel>;
@@ -453,4 +471,4 @@ export interface ICell {
  * @returns pure text in this cell
  */
 export declare function extractPureTextFromCell(cell: Nullable<ICellData>): string;
-export declare function getOriginCellValue(cell: Nullable<ICellData>): Nullable<import('./typedef').CellValue>;
+export declare function getOriginCellValue(cell: Nullable<ICellData>): Nullable<import("./typedef").CellValue>;

package/lib/types/skeleton.d.ts

@@ -1,4 +1,19 @@
-import { IFontLocale } from './sheets/util';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IFontLocale } from './sheets/util';
 import { LocaleService } from './services/locale/locale.service';
 import { Disposable } from './shared/lifecycle';
 export declare class Skeleton extends Disposable {

package/lib/types/slides/slide-model.d.ts

@@ -1,7 +1,23 @@
-import { Observable } from 'rxjs';
-import { Nullable } from '../shared';
-import { ISlideData, ISlidePage, PageType } from '../types/interfaces';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Observable } from 'rxjs';
+import type { Nullable } from '../shared';
+import type { ISlideData, ISlidePage } from '../types/interfaces';
 import { UnitModel, UniverInstanceType } from '../common/unit';
+import { PageType } from '../types/interfaces';
 export declare class SlideDataModel extends UnitModel<ISlideData, UniverInstanceType.UNIVER_SLIDE> {
     type: UniverInstanceType.UNIVER_SLIDE;
     private readonly _activePage$;
@@ -24,10 +40,10 @@ export declare class SlideDataModel extends UnitModel<ISlideData, UniverInstance
     getPageOrder(): string[] | undefined;
     getPage(pageId: string): ISlidePage | undefined;
     getElementsByPage(pageId: string): {
-        [elementId: string]: import('..').IPageElement;
+        [elementId: string]: import("..").IPageElement;
     } | undefined;
-    getElement(pageId: string, elementId: string): import('..').IPageElement | undefined;
-    getPageSize(): import('..').ISize;
+    getElement(pageId: string, elementId: string): import("..").IPageElement | undefined;
+    getPageSize(): import("..").ISize;
     getBlankPage(): {
         id: string;
         pageType: PageType;

package/lib/types/types/const/const.d.ts

@@ -1,6 +1,22 @@
-import { Nullable } from '../../shared';
-import { IParagraphStyle, ITextStyle, NamedStyleType } from '../interfaces';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Nullable } from '../../shared';
+import type { IParagraphStyle, ITextStyle } from '../interfaces';
 import { BooleanNumber, HorizontalAlign, TextDirection, VerticalAlign, WrapStrategy } from '../enum';
+import { NamedStyleType } from '../interfaces';
 /**
  * Used as an illegal range array return value
  */

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

@@ -1,3 +1,18 @@
-import { ISize } from '../../shared';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ISize } from '../../shared';
 import { PaperType } from '../interfaces';
 export declare const PAGE_SIZE: Record<PaperType, Required<ISize>>;

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

@@ -1,8 +1,23 @@
-import { Nullable } from '../../shared';
-import { ICellDataForSheetInterceptor, ICellWithCoord } from '../../sheets/typedef';
-import { Workbook } from '../../sheets/workbook';
-import { Worksheet } from '../../sheets/worksheet';
-import { IStyleData } from './i-style-data';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Nullable } from '../../shared';
+import type { ICellDataForSheetInterceptor, ICellWithCoord } from '../../sheets/typedef';
+import type { Workbook } from '../../sheets/workbook';
+import type { Worksheet } from '../../sheets/worksheet';
+import type { IStyleData } from './i-style-data';
 export interface ICellRenderContext {
     data: Nullable<ICellDataForSheetInterceptor>;
     style: Nullable<IStyleData>;

package/lib/types/types/interfaces/i-cell-validation-data.d.ts

@@ -1,5 +1,20 @@
-import { DataValidationStatus } from '../enum/data-validation-status';
-import { IDataValidationRule } from './i-data-validation';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { DataValidationStatus } from '../enum/data-validation-status';
+import type { IDataValidationRule } from './i-data-validation';
 export interface ICellValidationData {
     ruleId: string;
     validStatus: DataValidationStatus;

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

@@ -1,9 +1,24 @@
-import { IRange } from '../../sheets/typedef';
-import { DataValidationErrorStyle } from '../enum/data-validation-error-style';
-import { DataValidationImeMode } from '../enum/data-validation-ime-mode';
-import { DataValidationOperator } from '../enum/data-validation-operator';
-import { DataValidationRenderMode } from '../enum/data-validation-render-mode';
-import { DataValidationType } from '../enum/data-validation-type';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IRange } from '../../sheets/typedef';
+import type { DataValidationErrorStyle } from '../enum/data-validation-error-style';
+import type { DataValidationImeMode } from '../enum/data-validation-ime-mode';
+import type { DataValidationOperator } from '../enum/data-validation-operator';
+import type { DataValidationRenderMode } from '../enum/data-validation-render-mode';
+import type { DataValidationType } from '../enum/data-validation-type';
 export interface IDataValidationRuleBase {
     /**
      * data validation type

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

@@ -1,4 +1,19 @@
-import { ICustomDecoration, ICustomRange, IParagraph } from './i-document-data';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ICustomDecoration, ICustomRange, IParagraph } from './i-document-data';
 export interface ICustomRangeForInterceptor extends ICustomRange {
     active?: boolean;
     show?: boolean;

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

@@ -1,8 +1,23 @@
-import { ISize } from '../../shared/shape';
-import { BooleanNumber, CellValueType, HorizontalAlign, LocaleType, TextDirection, VerticalAlign, WrapStrategy } from '../enum';
-import { IDrawingParam } from './i-drawing';
-import { IMention } from './i-mention';
-import { IColorStyle, IStyleBase } from './i-style-data';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+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';
 /**
  * Properties of document
  */

package/lib/types/types/interfaces/i-drawing.d.ts

@@ -1,6 +1,21 @@
-import { IAbsoluteTransform, IGroupBaseBound } from '../../shared/shape';
-import { Nullable } from '../../shared/types';
-import { BooleanNumber } from '../enum/text-style';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IAbsoluteTransform, IGroupBaseBound } from '../../shared/shape';
+import type { Nullable } from '../../shared/types';
+import type { BooleanNumber } from '../enum/text-style';
 /**
  * The layer type of Drawing, used to distinguish between forward, backward, front, and back
  */
@@ -102,3 +117,41 @@ export interface IDrawingParam extends IDrawingSearch {
      */
     groupBaseBound?: Nullable<IGroupBaseBound>;
 }
+/**
+ * Describes a single group node's direct children in a group hierarchy.
+ */
+export interface IDrawingGroupNestedIds {
+    /** The drawing ID of the group itself. */
+    drawingId: string;
+    /**
+     * The drawing IDs of the direct children of this group (both group and
+     * non-group children). Does not include deeply-nested descendants.
+     */
+    children?: string[];
+}
+/**
+ * A flattened representation of a nested group hierarchy, produced by a
+ * post-order DFS traversal so that every child always appears before its
+ * parent in the respective arrays.
+ */
+export interface IDrawingGroupNestedParam {
+    /**
+     * A map from each group's drawingId to its {@link IDrawingGroupNestedIds}
+     * descriptor. Covers the root group and every nested sub-group. Look up
+     * any group's direct children in O(1) via `nestedIdRecord[groupId].children`.
+     */
+    nestedIdRecord: Record<string, IDrawingGroupNestedIds>;
+    /**
+     * All non-group (leaf) drawing params that belong anywhere in the group
+     * hierarchy. Post-order: a leaf always appears before the group that
+     * directly contains it.
+     */
+    flatChildren?: IDrawingParam[];
+    /**
+     * All group drawing params in the hierarchy (including the root group).
+     * Post-order: nested child groups appear before their parent group, so
+     * callers can safely iterate in order without dependency issues.
+     * The root group is always the last element.
+     */
+    groups: IDrawingParam[];
+}

package/lib/types/types/interfaces/i-mention.d.ts

@@ -1,4 +1,19 @@
-import { MentionType } from '../enum/mention-type';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { MentionType } from '../enum/mention-type';
 export interface IDocMention extends IMention {
     id: string;
 }

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

@@ -1,4 +1,19 @@
-import { IDisposable } from '@wendellhu/redi';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { IDisposable } from '@wendellhu/redi';
 export interface INeedCheckDisposable extends IDisposable {
     canDispose: () => boolean;
 }

package/lib/types/types/interfaces/i-placeholder.d.ts

@@ -1,4 +1,19 @@
-import { PlaceholderType } from '../enum/place-holder-type';
+/**
+ * Copyright 2023-present DreamNum Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PlaceholderType } from '../enum/place-holder-type';
 export interface IPlaceholder {
     type: PlaceholderType;
     index: number;