@univerjs/docs 1.0.0-insiders.20260809-70eefdd → 1.0.0-rc.0

package/lib/types/index.d.ts

@@ -21,18 +21,25 @@ export { SetDocumentDefaultParagraphStyleCommand } from './commands/commands/set
 export type { IDocumentDefaultParagraphStylePatch, ISetDocumentDefaultParagraphStyleCommandParams, } from './commands/commands/set-document-default-paragraph-style.command';
 export { SetDocumentNameCommand } from './commands/commands/set-document-name.command';
 export type { ISetDocumentNameCommandParams } from './commands/commands/set-document-name.command';
+export { SetDocumentPermissionCommand } from './commands/commands/set-document-permission.command';
+export type { ISetDocumentPermissionCommandParams } from './commands/commands/set-document-permission.command';
+export { SetDocumentPermissionsCommand } from './commands/commands/set-document-permissions.command';
 export { SetSectionHeaderFooterLinkCommand } from './commands/commands/set-section-header-footer-link.command';
 export type { ISetSectionHeaderFooterLinkCommandParams } from './commands/commands/set-section-header-footer-link.command';
 export { UpdateDocumentParagraphStyleCommand } from './commands/commands/update-document-paragraph-style.command';
 export { DeleteDocumentSectionBreakCommand, InsertDocumentColumnBreakCommand, InsertDocumentSectionBreakCommand, UpdateDocumentSectionCommand } from './commands/commands/update-document-section.command';
 export type { IDeleteDocumentSectionBreakCommandParams, IDocumentSectionConfig, IDocumentSectionUpdate, IInsertDocumentColumnBreakCommandParams, IInsertDocumentSectionBreakCommandParams, IUpdateDocumentSectionCommandParams } from './commands/commands/update-document-section.command';
-export { RichTextEditingMutation } from './commands/mutations/core-editing.mutation';
+export { DocHistoryAction, RichTextEditingMutation, transformDocumentTextRanges } from './commands/mutations/core-editing.mutation';
 export type { IRichTextEditingMutationParams } from './commands/mutations/core-editing.mutation';
+export { SetDocumentPermissionRuleMutation } from './commands/mutations/set-document-permission-rule.mutation';
+export { SetDocumentPermissionRulesMutation } from './commands/mutations/set-document-permission-rules.mutation';
 export { SetTextSelectionsOperation } from './commands/operations/text-selection.operation';
 export type { ISetTextSelectionsOperationParams } from './commands/operations/text-selection.operation';
 export type { IUniverDocsConfig } from './config/config';
 export { createDocsCustomBlockDrawing, createDocsCustomBlockInsertMutation, createDocsCustomBlockRemoveMutation, createEmbedDocsCustomBlockData, createInsertCustomBlockActions, createRemoveCustomBlockActions, EMBED_DOCS_CUSTOM_BLOCK_DEFAULT_COMPONENT_KEY, isEmbedDocsCustomBlockData, isSheetLikeDocsCustomBlockChildType, resolveDocsCustomBlockSize, shouldUseInlineTextSelectionForDocsCustomBlockDrawing, } from './embed-host-anchor';
 export type { EmbedDocsCustomBlockInteractionMode, IDocsCustomBlockMutationParams, IEmbedDocsCustomBlockData, } from './embed-host-anchor';
+export { DocsLayoutWorkerCapabilityError, DocsLayoutWorkerClientService, startDocsLayoutWorker, UniverDocsLayoutWorkerPlugin } from './layout-worker';
+export type { IDocsLayoutWorkerCapabilities, IDocsLayoutWorkerFontProbe, IDocsLayoutWorkerRuntime, IUniverDocsLayoutWorkerConfig } from './layout-worker';
 export { UniverDocsPlugin } from './plugin';
 export { DocBlockMoveValidatorService } from './services/doc-block-move-validator.service';
 export type { DocBlockMoveTransformer, DocBlockMoveValidator, IDocBlockMoveResult, IDocBlockMoveTransformContext, IDocBlockMoveValidationContext, } from './services/doc-block-move-validator.service';
@@ -40,6 +47,8 @@ export { DocContentInsertService } from './services/doc-content-insert.service';
 export type { IDocContentInsertRange } from './services/doc-content-insert.service';
 export { DocInterceptorService } from './services/doc-interceptor/doc-interceptor.service';
 export { DOC_INTERCEPTOR_POINT } from './services/doc-interceptor/interceptor-const';
+export { DocLayoutExecutorService, DocLayoutExecutorState, DocLayoutExecutorType, DocLayoutSessionStatus, } from './services/doc-layout-executor.service';
+export type { IDocLayoutCancelRequest, IDocLayoutCreateSessionRequest, IDocLayoutCustomRangePresentation, IDocLayoutCustomRangePresentationContext, IDocLayoutCustomRangePresentationEntry, IDocLayoutCustomRangePresentationPatch, IDocLayoutDisposeMountRequest, IDocLayoutDisposeSessionRequest, IDocLayoutExecutor, IDocLayoutExecutorStatus, IDocLayoutMountIdentity, IDocLayoutMutationProjection, IDocLayoutPageRequest, IDocLayoutPageResult, IDocLayoutPerformanceMetrics, IDocLayoutRecordPatch, IDocLayoutStartOptions, IDocLayoutStartRequest, IDocLayoutStartResult, IDocLayoutStepRequest, IDocLayoutStepResult, } from './services/doc-layout-executor.service';
 export { DOC_SELECTION_OPTION_PRESERVE_CARET, DocSelectionManagerService, } from './services/doc-selection-manager.service';
 export { DocSkeletonManagerService } from './services/doc-skeleton-manager.service';
 export { DocStateChangeManagerService, IDocStateChangeInterceptorService, } from './services/doc-state-change-manager.service';
@@ -47,6 +56,9 @@ export type { IDocStateChangeInfo, IDocStateChangeParams } from './services/doc-
 export { DocStateEmitService } from './services/doc-state-emit.service';
 export { DocTextResolverService } from './services/doc-text-resolver.service';
 export type { IDocTextReplacement, IDocTextResolver, IResolvedDocText, IResolvedDocTextCharacter, } from './services/doc-text-resolver.service';
+export { canEditDocumentTargets, createDocumentPermissionPoint, DOCUMENT_UNIT_PERMISSION_ACTIONS, getDocumentEntityPermissionObjectId, getDocumentParagraphPermissionObjectId, getDocumentPermissionValue, getDocumentSectionPermissionObjectId, setDocumentPermissionValue, } from './services/permission/document-permission';
+export type { DocumentUnitPermissionAction } from './services/permission/document-permission';
+export { getDocumentDrawingSegmentId, getDocumentEditTargetObjectIds, getDocumentEntityParentPermissionObjectIds, getDocumentParagraphParentPermissionObjectIds, } from './services/permission/document-permission-resolver';
 export { addCustomRangeBySelectionFactory, addCustomRangeFactory, deleteCustomRangeFactory, } from './utils/custom-range-factory';
 export { generateParagraphs } from './utils/paragraphs';
 export { replaceSelectionFactory } from './utils/replace-selection-factory';

package/lib/types/layout-worker/config/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+export declare const DOCS_LAYOUT_WORKER_PLUGIN_CONFIG_KEY = "docs-layout-worker.config";
+export declare const configSymbol: unique symbol;
+export declare const DEFAULT_DOCS_LAYOUT_WORKER_REQUEST_TIMEOUT_MS = 15000;
+export interface IUniverDocsLayoutWorkerConfig {
+    workerFactory?: () => Worker;
+    /** Maximum time allowed for one Worker RPC request before recovery starts. */
+    requestTimeoutMs?: number;
+}
+export declare const defaultPluginDocsLayoutWorkerConfig: IUniverDocsLayoutWorkerConfig;

package/lib/types/layout-worker/document-font-metrics.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+/** Collect once from the snapshot, then only from mutation payloads (including JSON1 font replacements). */
+export declare function collectDocumentFontFamilies(value: unknown, families: Set<string>): void;
+export declare function measureDocumentFontFamilies(families: Set<string>): Record<string, number>;

package/lib/types/layout-worker/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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 { IDocLayoutCancelRequest, IDocLayoutCreateSessionRequest, IDocLayoutDisposeMountRequest, IDocLayoutDisposeSessionRequest, IDocLayoutExecutor, IDocLayoutPageRequest, IDocLayoutPageResult, IDocLayoutPerformanceMetrics, IDocLayoutStartRequest, IDocLayoutStartResult, IDocLayoutStepRequest, IDocLayoutStepResult } from '../services/doc-layout-executor.service';
+import type { IUniverDocsLayoutWorkerConfig } from './config/config';
+import type { IDocsLayoutWorkerCapabilities } from './protocol';
+import { Disposable, IConfigService, Injector, Plugin } from '@univerjs/core';
+import { DocLayoutExecutorService, DocLayoutExecutorType } from '../services/doc-layout-executor.service';
+import { startDocsLayoutWorker } from './worker';
+export declare class DocsLayoutWorkerCapabilityError extends Error {
+    constructor(message: string);
+}
+export declare class DocsLayoutWorkerClientService extends Disposable implements IDocLayoutExecutor {
+    private readonly _workerFactory;
+    private readonly _requestTimeoutMs;
+    readonly type = DocLayoutExecutorType.WORKER;
+    private _worker;
+    private _channelService;
+    private _runtime;
+    private _initialization;
+    private _initialized;
+    private readonly _performanceTracker;
+    private readonly _fontFamilies;
+    constructor(_workerFactory: () => Worker, _requestTimeoutMs?: number);
+    initialize(): Promise<void>;
+    getCapabilities(): Promise<IDocsLayoutWorkerCapabilities>;
+    recover(): Promise<void>;
+    createSession(request: IDocLayoutCreateSessionRequest): Promise<void>;
+    startLayout(request: IDocLayoutStartRequest): Promise<IDocLayoutStartResult>;
+    stepLayout(request: IDocLayoutStepRequest): Promise<IDocLayoutStepResult>;
+    publishBacklog(request: Omit<IDocLayoutStepRequest, 'budgetMs'>): Promise<IDocLayoutStepResult>;
+    getLayoutPage(request: IDocLayoutPageRequest): Promise<IDocLayoutPageResult>;
+    cancelLayout(request: IDocLayoutCancelRequest): Promise<void>;
+    getPerformanceMetrics(unitId: string): Promise<Omit<IDocLayoutPerformanceMetrics, 'hydrationMs'>>;
+    resetPerformanceMetrics(unitId: string): Promise<void>;
+    disposeLayoutMount(request: IDocLayoutDisposeMountRequest): Promise<void>;
+    disposeSession(request: IDocLayoutDisposeSessionRequest): Promise<void>;
+    dispose(): void;
+    private _replaceRuntime;
+    private _disposeRuntime;
+    private _getRuntime;
+    private _withTimeout;
+    private _verifyCapabilities;
+}
+export declare class UniverDocsLayoutWorkerPlugin extends Plugin {
+    private readonly _config;
+    readonly _injector: Injector;
+    private readonly _layoutExecutorService;
+    private readonly _configService;
+    static pluginName: string;
+    static packageName: string;
+    static version: string;
+    constructor(_config: Partial<IUniverDocsLayoutWorkerConfig> | undefined, _injector: Injector, _layoutExecutorService: DocLayoutExecutorService, _configService: IConfigService);
+    onStarting(): void;
+}
+export type { IUniverDocsLayoutWorkerConfig } from './config/config';
+export type { IDocsLayoutWorkerCapabilities, IDocsLayoutWorkerFontProbe, IDocsLayoutWorkerRuntime } from './protocol';
+export { startDocsLayoutWorker };

package/lib/types/layout-worker/performance-tracker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { IDocLayoutPerformanceMetrics } from '../services/doc-layout-executor.service';
+type WorkerTransferMetrics = Omit<IDocLayoutPerformanceMetrics, 'hydrationMs'>;
+export declare class DocsLayoutWorkerPerformanceTracker {
+    private readonly _metrics;
+    recordRequest(message: unknown, durationMs: number): void;
+    recordResponse(message: unknown, durationMs: number): void;
+    getMetrics(unitId: string): WorkerTransferMetrics;
+    reset(unitId: string): void;
+    resetAll(): void;
+    private _append;
+}
+export {};

package/lib/types/layout-worker/protocol.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 { DocLayoutExecutorType, IDocLayoutExecutor } from '../services/doc-layout-executor.service';
+export declare const DOCS_LAYOUT_WORKER_CHANNEL = "univer.docs-layout-worker";
+export declare const DOCS_LAYOUT_WORKER_PROTOCOL_VERSION = 5;
+export interface IDocsLayoutWorkerFontProbe {
+    content: string;
+    font: string;
+    width: number;
+    actualBoundingBoxAscent: number;
+    actualBoundingBoxDescent: number;
+}
+export interface IDocsLayoutWorkerCapabilities {
+    protocolVersion: typeof DOCS_LAYOUT_WORKER_PROTOCOL_VERSION;
+    executor: DocLayoutExecutorType.WORKER;
+    offscreenCanvas: boolean;
+    structuredClone: boolean;
+    fontProbe: IDocsLayoutWorkerFontProbe;
+}
+export interface IDocsLayoutWorkerRuntime extends IDocLayoutExecutor {
+    getCapabilities(): Promise<IDocsLayoutWorkerCapabilities>;
+}

package/lib/types/layout-worker/worker.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 { IDocLayoutCancelRequest, IDocLayoutCreateSessionRequest, IDocLayoutDisposeMountRequest, IDocLayoutDisposeSessionRequest, IDocLayoutPageRequest, IDocLayoutPageResult, IDocLayoutPerformanceMetrics, IDocLayoutStartRequest, IDocLayoutStartResult, IDocLayoutStepRequest, IDocLayoutStepResult } from '../services/doc-layout-executor.service';
+import type { IDocsLayoutWorkerCapabilities, IDocsLayoutWorkerRuntime } from './protocol';
+import { ChannelService } from '@univerjs/rpc';
+import { DocLayoutExecutorType } from '../services/doc-layout-executor.service';
+import { DocsLayoutWorkerPerformanceTracker } from './performance-tracker';
+export declare class DocsLayoutWorkerRuntime implements IDocsLayoutWorkerRuntime {
+    private readonly _performanceTracker;
+    private readonly _sessions;
+    readonly type = DocLayoutExecutorType.WORKER;
+    constructor(_performanceTracker?: DocsLayoutWorkerPerformanceTracker);
+    initialize(): Promise<void>;
+    getCapabilities(): Promise<IDocsLayoutWorkerCapabilities>;
+    recover(): Promise<void>;
+    createSession(request: IDocLayoutCreateSessionRequest): Promise<void>;
+    startLayout(request: IDocLayoutStartRequest): Promise<IDocLayoutStartResult>;
+    private _applyMutations;
+    private _applyCustomRangePresentations;
+    private _updateCustomRangePresentations;
+    stepLayout(request: IDocLayoutStepRequest): Promise<IDocLayoutStepResult>;
+    publishBacklog(request: Omit<IDocLayoutStepRequest, 'budgetMs'>): Promise<IDocLayoutStepResult>;
+    getLayoutPage(request: IDocLayoutPageRequest): Promise<IDocLayoutPageResult>;
+    cancelLayout(request: IDocLayoutCancelRequest): Promise<void>;
+    getPerformanceMetrics(unitId: string): Promise<Omit<IDocLayoutPerformanceMetrics, 'hydrationMs'>>;
+    resetPerformanceMetrics(unitId: string): Promise<void>;
+    disposeLayoutMount(request: IDocLayoutDisposeMountRequest): Promise<void>;
+    disposeSession(request: IDocLayoutDisposeSessionRequest): Promise<void>;
+    dispose(): void;
+    private _getSession;
+    private _getLayoutMount;
+    private _runLayoutStep;
+    private _runWithCustomBlockViewports;
+    private _disposeSession;
+}
+export declare function startDocsLayoutWorker(): ChannelService;

package/lib/types/services/doc-interceptor/interceptor-const.d.ts

@@ -13,11 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { ICustomDecoration, ICustomDecorationForInterceptor, ICustomRange, ICustomRangeForInterceptor } from '@univerjs/core';
+import type { ICustomDecoration, ICustomDecorationForInterceptor, ICustomRange, ICustomRangeForInterceptor, IDocumentBody } from '@univerjs/core';
 export declare const DOC_INTERCEPTOR_POINT: {
     CUSTOM_RANGE: import("@univerjs/core").IInterceptor<ICustomRangeForInterceptor, {
         index: number;
         unitId: string;
+        body: IDocumentBody | undefined;
         customRanges: ICustomRange[];
     }>;
     CUSTOM_DECORATION: import("@univerjs/core").IInterceptor<ICustomDecorationForInterceptor, {

package/lib/types/services/doc-layout-executor.service.d.ts

@@ -0,0 +1,218 @@
+/**
+ * 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 { ICustomRange, IDisposable, IDocumentBody, IDocumentData, ILanguagePack, JSONXActions, LocaleType, Nullable } from '@univerjs/core';
+import type { IDocsCustomBlockRenderViewport, IDocumentLayoutPagePublication, IDocumentLayoutSessionStartOptions, IDocumentLayoutStepResult } from '@univerjs/engine-render';
+import { Disposable, ICommandService, ILogService, IUniverInstanceService, LocaleService } from '@univerjs/core';
+export declare enum DocLayoutExecutorType {
+    MAIN_THREAD = "main-thread",
+    WORKER = "worker"
+}
+export declare enum DocLayoutSessionStatus {
+    ACCEPTED = "accepted",
+    NOT_FOUND = "not-found",
+    RESNAPSHOT_REQUIRED = "resnapshot-required",
+    SUPERSEDED = "superseded"
+}
+export declare enum DocLayoutExecutorState {
+    UNREGISTERED = "unregistered",
+    INITIALIZING = "initializing",
+    ACTIVE = "active",
+    RECOVERING = "recovering",
+    FAILED = "failed"
+}
+export interface IDocLayoutExecutorStatus {
+    state: DocLayoutExecutorState;
+    executor: DocLayoutExecutorType | null;
+    diagnostic: string | null;
+    recoveryUnitId: string | null;
+}
+export interface IDocLayoutPerformanceMetrics {
+    hydrationMs: number[];
+    mutationTransferMs: number[];
+    patchTransferMs: number[];
+    snapshotTransferMs: number[];
+}
+export interface IDocLayoutCreateSessionRequest {
+    normalFontLineHeights?: Record<string, number>;
+    unitId: string;
+    sessionEpoch: number;
+    snapshot: IDocumentData;
+    modelRevision: number;
+    locale: LocaleType;
+    localeData?: ILanguagePack;
+    direction: 'ltr' | 'rtl';
+}
+export interface IDocLayoutDisposeSessionRequest {
+    unitId: string;
+    sessionEpoch: number;
+}
+export interface IDocLayoutMutationProjection {
+    baseRevision: number;
+    modelRevision: number;
+    actions: JSONXActions;
+}
+export interface IDocLayoutMountIdentity {
+    unitId: string;
+    mountId: string;
+    mountEpoch: number;
+    viewportEpoch: number;
+}
+export interface IDocLayoutStartRequest extends IDocLayoutMountIdentity {
+    normalFontLineHeights?: Record<string, number>;
+    metricsRevision: number;
+    baseRevision: number;
+    modelRevision: number;
+    mutations: IDocLayoutMutationProjection[];
+    reason: 'initial' | 'edit';
+    anchor?: number;
+    priorityAnchor?: number;
+    invalidation?: IDocumentLayoutSessionStartOptions['invalidation'];
+    customBlockViewports?: Record<string, IDocsCustomBlockRenderViewport>;
+    customBlockViewportPatch?: IDocLayoutRecordPatch<IDocsCustomBlockRenderViewport>;
+    customRangePresentations?: IDocLayoutCustomRangePresentationEntry[];
+    customRangePresentationPatch?: IDocLayoutCustomRangePresentationPatch;
+    budgetMs: number;
+}
+export interface IDocLayoutRecordPatch<T> {
+    removals: string[];
+    upserts: Record<string, T>;
+}
+export interface IDocLayoutCustomRangePresentation {
+    active?: boolean;
+    glyphAscentEm?: number;
+    glyphDescentEm?: number;
+    glyphWidthEm?: number;
+    show?: boolean;
+}
+export interface IDocLayoutCustomRangePresentationEntry {
+    segmentId: string;
+    rangeId: string;
+    presentation: IDocLayoutCustomRangePresentation;
+}
+export interface IDocLayoutCustomRangePresentationPatch {
+    removals: Array<Pick<IDocLayoutCustomRangePresentationEntry, 'segmentId' | 'rangeId'>>;
+    upserts: IDocLayoutCustomRangePresentationEntry[];
+}
+export interface IDocLayoutCustomRangePresentationContext {
+    segmentId: string;
+    body: IDocumentBody;
+}
+type DocLayoutCustomRangePresentationProvider = (unitId: string, range: ICustomRange, context: IDocLayoutCustomRangePresentationContext) => IDocLayoutCustomRangePresentation | null | undefined;
+export type IDocLayoutStartResult = {
+    status: DocLayoutSessionStatus.ACCEPTED;
+    step: IDocLayoutStepResult;
+} | {
+    status: DocLayoutSessionStatus.NOT_FOUND;
+} | {
+    status: DocLayoutSessionStatus.SUPERSEDED;
+} | {
+    status: DocLayoutSessionStatus.RESNAPSHOT_REQUIRED;
+    modelRevision: number;
+};
+export interface IDocLayoutStepRequest extends IDocLayoutMountIdentity {
+    generation: number;
+    budgetMs: number;
+}
+export interface IDocLayoutPageRequest extends IDocLayoutMountIdentity {
+    pageIndex: number;
+}
+export interface IDocLayoutPageResult extends IDocLayoutMountIdentity {
+    modelRevision: number;
+    metricsRevision: number;
+    page: IDocumentLayoutPagePublication | null;
+}
+export interface IDocLayoutCancelRequest extends IDocLayoutMountIdentity {
+    generation?: number;
+}
+export type IDocLayoutDisposeMountRequest = IDocLayoutMountIdentity;
+export interface IDocLayoutStepResult extends IDocumentLayoutStepResult, IDocLayoutMountIdentity {
+    modelRevision: number;
+    metricsRevision: number;
+}
+export interface IDocLayoutExecutor {
+    readonly type: DocLayoutExecutorType;
+    initialize(): Promise<void>;
+    recover(): Promise<void>;
+    /**
+     * Capture the request synchronously before returning. The source document model remains mutable
+     * while the returned promise tracks remote session creation.
+     */
+    createSession(request: IDocLayoutCreateSessionRequest): Promise<void>;
+    startLayout(request: IDocLayoutStartRequest): Promise<IDocLayoutStartResult>;
+    stepLayout(request: IDocLayoutStepRequest): Promise<IDocLayoutStepResult>;
+    publishBacklog(request: Omit<IDocLayoutStepRequest, 'budgetMs'>): Promise<IDocLayoutStepResult>;
+    getLayoutPage(request: IDocLayoutPageRequest): Promise<IDocLayoutPageResult>;
+    cancelLayout(request: IDocLayoutCancelRequest): Promise<void>;
+    getPerformanceMetrics(unitId: string): Promise<Omit<IDocLayoutPerformanceMetrics, 'hydrationMs'>>;
+    resetPerformanceMetrics(unitId: string): Promise<void>;
+    disposeLayoutMount(request: IDocLayoutDisposeMountRequest): Promise<void>;
+    disposeSession(request: IDocLayoutDisposeSessionRequest): Promise<void>;
+}
+export interface IDocLayoutStartOptions {
+    reason: 'initial' | 'edit';
+    anchor?: number;
+    priorityAnchor?: number;
+    invalidation?: IDocumentLayoutSessionStartOptions['invalidation'];
+}
+export declare class DocLayoutExecutorService extends Disposable {
+    private readonly _univerInstanceService;
+    private readonly _commandService;
+    private readonly _localeService;
+    private readonly _logService;
+    private static readonly _performanceSampleLimit;
+    private _executor;
+    private _executorReady;
+    private _recoveryFailure;
+    private _sessionEpoch;
+    private readonly _sessions;
+    private readonly _hydrationSamples;
+    private readonly _customRangePresentationProviders;
+    private readonly _executorStatus$;
+    readonly executorStatus$: import("rxjs").Observable<IDocLayoutExecutorStatus>;
+    constructor(_univerInstanceService: IUniverInstanceService, _commandService: ICommandService, _localeService: LocaleService, _logService: ILogService);
+    register(executor: IDocLayoutExecutor): IDisposable;
+    getExecutor(): Nullable<IDocLayoutExecutor>;
+    getExecutorStatus(): IDocLayoutExecutorStatus;
+    registerCustomRangePresentationProvider(provider: DocLayoutCustomRangePresentationProvider): IDisposable;
+    getPerformanceMetrics(unitId: string): Promise<IDocLayoutPerformanceMetrics>;
+    resetPerformanceMetrics(unitId: string): Promise<void>;
+    recordHydrationDuration(unitId: string, durationMs: number): void;
+    recoverExecutor(unitId: string, diagnostic: string): Promise<void>;
+    completeRecovery(unitId: string): void;
+    startLayout(identity: IDocLayoutMountIdentity, options: IDocLayoutStartOptions, budgetMs: number): Promise<IDocLayoutStartResult | null>;
+    stepLayout(request: IDocLayoutStepRequest): Promise<IDocLayoutStepResult>;
+    publishBacklog(request: Omit<IDocLayoutStepRequest, 'budgetMs'>): Promise<IDocLayoutStepResult>;
+    getLayoutPage(request: IDocLayoutPageRequest): Promise<IDocLayoutPageResult>;
+    cancelLayout(request: IDocLayoutCancelRequest): Promise<void>;
+    disposeLayoutMount(request: IDocLayoutDisposeMountRequest): Promise<void>;
+    dispose(): void;
+    private _createSessionIfEligible;
+    private _enqueueCommittedMutation;
+    private _startSynchronizedLayout;
+    private _createLayoutProjectionPayload;
+    private _replaceSession;
+    private _disposeSession;
+    private _getEligibleModel;
+    private _getRequiredModel;
+    private _collectCustomRangePresentations;
+    private _isEligible;
+    private _requireExecutor;
+    private _appendPerformanceSample;
+    private _createSessionOnNextMacroTask;
+    private _markSessionDisposed;
+    private _disposeManagedSessions;
+}
+export {};

package/lib/types/services/doc-selection-manager.service.d.ts

@@ -50,7 +50,7 @@ export declare class DocSelectionManagerService extends RxDisposable {
     private _listenCurrentUnit;
     __getCurrentSelection(): Nullable<IDocSelectionManagerSearchParam>;
     getSelectionInfo(params?: Nullable<IDocSelectionManagerSearchParam>): IDocSelectionInnerParam | undefined;
-    refreshSelection(params?: Nullable<IDocSelectionManagerSearchParam>): void;
+    refreshSelection(params?: Nullable<IDocSelectionManagerSearchParam>, isEditing?: boolean): void;
     __TEST_ONLY_setCurrentSelection(param: IDocSelectionManagerSearchParam): void;
     getTextRanges(params?: Nullable<IDocSelectionManagerSearchParam>): Readonly<Nullable<ITextRangeWithStyle[]>>;
     getRectRanges(params?: Nullable<IDocSelectionManagerSearchParam>): Readonly<Nullable<IRectRangeWithStyle[]>>;
@@ -60,6 +60,12 @@ export declare class DocSelectionManagerService extends RxDisposable {
     replaceDocRanges(docRanges: ISuccinctDocRangeParam[], params?: Nullable<IDocSelectionManagerSearchParam>, isEditing?: boolean, options?: {
         [key: string]: boolean;
     }): void;
+    /**
+     * Replaces logical selection state without rebuilding render ranges. Atomic
+     * external mutations use this before applying document actions so layout can
+     * follow transformed offsets, then refresh after new geometry is available.
+     */
+    replaceSelectionInfoWithoutRefresh(selectionInfo: IDocSelectionInnerParam, params?: Nullable<IDocSelectionManagerSearchParam>): void;
     __replaceTextRangesWithNoRefresh(textSelectionInfo: IDocSelectionInnerParam, search: IDocSelectionManagerSearchParam): void;
     dispose(): void;
     private _setCurrentSelectionNotRefresh;

package/lib/types/services/doc-skeleton-manager.service.d.ts

@@ -17,6 +17,7 @@ import type { DocumentDataModel, Nullable } from '@univerjs/core';
 import type { IRenderContext, IRenderModule } from '@univerjs/engine-render';
 import { IUniverInstanceService, LocaleService, RxDisposable } from '@univerjs/core';
 import { DocumentSkeleton, DocumentViewModel } from '@univerjs/engine-render';
+import { DocLayoutExecutorService } from './doc-layout-executor.service';
 /**
  * This service is for document build and manage doc skeletons. It also manages
  * DocumentViewModels.
@@ -25,6 +26,7 @@ export declare class DocSkeletonManagerService extends RxDisposable implements I
     private readonly _context;
     private readonly _localeService;
     private readonly _univerInstanceService;
+    private readonly _docLayoutExecutorService;
     private _skeleton;
     private _docViewModel;
     private readonly _currentSkeleton$;
@@ -33,11 +35,14 @@ export declare class DocSkeletonManagerService extends RxDisposable implements I
     readonly currentSkeletonBefore$: import("rxjs").Observable<Nullable<DocumentSkeleton>>;
     private readonly _currentViewModel$;
     readonly currentViewModel$: import("rxjs").Observable<Nullable<DocumentViewModel>>;
-    constructor(_context: IRenderContext<DocumentDataModel>, _localeService: LocaleService, _univerInstanceService: IUniverInstanceService);
+    constructor(_context: Pick<IRenderContext<DocumentDataModel>, 'type' | 'unit' | 'unitId'>, _localeService: LocaleService, _univerInstanceService: IUniverInstanceService, _docLayoutExecutorService: DocLayoutExecutorService);
     dispose(): void;
     getSkeleton(): DocumentSkeleton;
     getViewModel(): DocumentViewModel;
+    getLayoutPerformanceMetrics(): ReturnType<DocLayoutExecutorService['getPerformanceMetrics']>;
+    supportsIncrementalLayout(): boolean;
     recalculate(): DocumentSkeleton;
+    private _publishSkeleton;
     private _init;
     private _update;
     private _buildSkeleton;

package/lib/types/services/doc-state-change-manager.service.d.ts

@@ -43,6 +43,7 @@ export declare class DocStateChangeManagerService extends RxDisposable {
         collaboration: IDocStateChangeParams[];
     };
     setStateCache(unitId: string, cache: IStateCache): void;
+    clearHistory(unitId: string): void;
     private _setChangeState;
     private _initialize;
     private _listenDocStateChange;

package/lib/types/services/doc-state-emit.service.d.ts

@@ -19,6 +19,10 @@ import { RxDisposable } from '@univerjs/core';
 interface IDocChangeState {
     actions: JSONXActions;
     textRanges: Nullable<ITextRangeWithStyle[]>;
+    options?: {
+        [key: string]: boolean;
+    };
+    isEditing?: boolean;
 }
 export interface IDocStateChangeParams {
     commandId: string;

package/lib/types/services/document-layout-snapshot.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 { IDocumentData } from '@univerjs/core';
+/**
+ * Builds the model snapshot owned by the layout Worker. Exchange-only payloads
+ * remain in the authoritative Main model and are deliberately excluded from
+ * the structured-clone boundary because they do not affect document geometry.
+ */
+export declare function createDocumentLayoutSnapshot(snapshot: IDocumentData): IDocumentData;

package/lib/types/services/permission/document-permission-resolver.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 { DocumentDataModel, IDocumentBody, JSONXActions } from '@univerjs/core';
+export interface IDocumentPermissionRange {
+    startOffset: number;
+    endOffset: number;
+}
+export declare function getDocumentDrawingSegmentId(documentDataModel: DocumentDataModel, drawingId: string): string;
+export declare function getDocumentEditTargetObjectIds(documentDataModel: DocumentDataModel, segmentId: string, range: IDocumentPermissionRange): string[];
+export declare function getDocumentEditTargetObjectIdsFromActions(documentDataModel: DocumentDataModel, segmentId: string, actions: JSONXActions): string[];
+export declare function getDocumentEntityParentPermissionObjectIds(documentDataModel: DocumentDataModel, segmentId: string, entityType: string, entityId: string): string[];
+export declare function getDocumentParagraphParentPermissionObjectIds(documentDataModel: DocumentDataModel, segmentId: string, paragraphId: string): string[];
+export declare function getDocumentSectionPermissionObjectIdsByIds(sectionIds: Iterable<string>): string[];
+export declare function getDocumentSectionIdsAtOffset(body: IDocumentBody, offset: number): string[];