@univerjs/sheets 0.20.1 → 0.21.0

package/lib/types/facade/permission/f-worksheet-permission.d.ts

@@ -13,11 +13,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { Observable } from 'rxjs';
 import type { FRange } from '../f-range';
 import type { FWorksheet } from '../f-worksheet';
-import type { IRangeProtectionOptions, IWorksheetPermissionConfig, IWorksheetProtectionOptions, UnsubscribeFn, WorksheetMode, WorksheetPermissionSnapshot } from './permission-types';
+import type { IRangeProtectionOptions, IWorksheetPermissionConfig, IWorksheetProtectionOptions, WorksheetMode, WorksheetPermissionSnapshot } from './permission-types';
 import { IAuthzIoService, ICommandService, Injector, IPermissionService } from '@univerjs/core';
+import { FBase } from '@univerjs/core/facade';
 import { RangeProtectionRuleModel, WorksheetProtectionPointModel, WorksheetProtectionRuleModel } from '@univerjs/sheets';
 import { FRangeProtectionRule } from './f-range-protection-rule';
 import { WorksheetPermissionPoint } from './permission-types';
@@ -27,7 +27,7 @@ import { WorksheetPermissionPoint } from './permission-types';
  *
  * @hideconstructor
  */
-export declare class FWorksheetPermission {
+export declare class FWorksheetPermission extends FBase {
     private readonly _worksheet;
     private readonly _injector;
     private readonly _permissionService;
@@ -36,95 +36,22 @@ export declare class FWorksheetPermission {
     private readonly _rangeProtectionRuleModel;
     private readonly _worksheetProtectionPointModel;
     private readonly _worksheetProtectionRuleModel;
-    private readonly _permissionSubject;
-    private readonly _rangeRulesSubject;
-    /**
-     * Observable stream of permission snapshot changes (BehaviorSubject)
-     * Emits immediately on subscription with current state, then on any permission point change
-     */
-    readonly permission$: Observable<WorksheetPermissionSnapshot>;
-    /**
-     * Observable stream of individual permission point changes
-     * Emits when a specific permission point value changes
-     */
-    readonly pointChange$: Observable<{
-        point: WorksheetPermissionPoint;
-        value: boolean;
-        oldValue: boolean;
-    }>;
-    /**
-     * Observable stream of range protection rule changes
-     * Emits when protection rules are added, updated, or deleted
-     */
-    readonly rangeProtectionChange$: Observable<{
-        type: 'add' | 'update' | 'delete';
-        rules: FRangeProtectionRule[];
-    }>;
-    /**
-     * Observable stream of current range protection rules list (BehaviorSubject)
-     * Emits immediately on subscription with current rules, then auto-updates when rules change
-     */
-    readonly rangeProtectionRules$: Observable<FRangeProtectionRule[]>;
     private readonly _unitId;
     private readonly _subUnitId;
-    private readonly _subscriptions;
-    private readonly _fPermission;
     constructor(_worksheet: FWorksheet, _injector: Injector, _permissionService: IPermissionService, _authzIoService: IAuthzIoService, _commandService: ICommandService, _rangeProtectionRuleModel: RangeProtectionRuleModel, _worksheetProtectionPointModel: WorksheetProtectionPointModel, _worksheetProtectionRuleModel: WorksheetProtectionRuleModel);
     /**
-     * Create permission snapshot stream from IPermissionService
-     * @private
-     */
-    private _createPermissionStream;
-    /**
-     * Create point change stream from IPermissionService
-     * @private
-     */
-    private _createPointChangeStream;
-    /**
-     * Create range protection change stream from RangeProtectionRuleModel
-     * @private
-     */
-    private _createRangeProtectionChangeStream;
-    /**
-     * Create range protection rules list stream from RangeProtectionRuleModel
-     * @private
-     */
-    private _createRangeProtectionRulesStream;
-    /**
-     * Extract WorksheetPermissionPoint type from permission point ID
-     * @private
-     */
-    private _extractWorksheetPointType;
-    /**
-     * Read the actual edit permission from a rule's permissionId
-     */
-    private _getRuleEditPermission;
-    /**
-     * Build permission snapshot
-     */
-    private _buildSnapshot;
-    /**
-     * Build range protection rules list
-     */
-    private _buildRangeProtectionRules;
-    /**
-     * Build Facade objects for all protection rules
-     */
-    private _buildProtectionRule;
-    /**
-     * Debug cell permission information.
-     * @param {number} row Row index.
-     * @param {number} col Column index.
-     * @returns {ICellPermissionDebugInfo | null} Debug information about which rules affect this cell, or null if no rules apply.
+     * Check if worksheet is currently protected.
+     * @returns {boolean} true if protected, false otherwise.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const debugInfo = permission?.debugCellPermission(0, 0);
-     * console.log(debugInfo);
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * if (fWorksheet.getWorksheetPermission().isProtected()) {
+     *   console.log('Worksheet is protected');
+     * }
      * ```
      */
-    debugCellPermission(row: number, col: number): FRangeProtectionRule | undefined;
+    isProtected(): boolean;
     /**
      * Create worksheet protection with collaborators support.
      * This must be called before setting permission points for collaboration to work.
@@ -132,11 +59,12 @@ export declare class FWorksheetPermission {
      * @returns {Promise<string>} The permissionId for the created protection.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const permission = fWorksheet.getWorksheetPermission();
      *
      * // Create worksheet protection with collaborators
-     * const permissionId = await permission?.protect({
+     * const permissionId = await permission.protect({
      *   allowedUsers: ['user1', 'user2'],
      *   name: 'My Worksheet Protection'
      * });
@@ -152,25 +80,12 @@ export declare class FWorksheetPermission {
      * @returns {Promise<void>} A promise that resolves when protection is removed.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.unprotect();
-     * ```
-     */
-    unprotect(): Promise<void>;
-    /**
-     * Check if worksheet is currently protected.
-     * @returns {boolean} true if protected, false otherwise.
-     * @example
-     * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * if (permission?.isProtected()) {
-     *   console.log('Worksheet is protected');
-     * }
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * await fWorksheet.getWorksheetPermission().unprotect();
      * ```
      */
-    isProtected(): boolean;
+    unprotect(): Promise<boolean>;
     /**
      * Set permission mode for the worksheet.
      * Automatically creates worksheet protection if not already protected.
@@ -178,9 +93,9 @@ export declare class FWorksheetPermission {
      * @returns {Promise<void>} A promise that resolves when the mode is set.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.setMode('readOnly');
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * await fWorksheet.getWorksheetPermission().setMode('readOnly');
      * ```
      */
     setMode(mode: WorksheetMode): Promise<void>;
@@ -189,19 +104,14 @@ export declare class FWorksheetPermission {
      * @private
      */
     private _getModePermissions;
-    /**
-     * Batch set multiple permission points efficiently
-     * @private
-     */
-    private _batchSetPermissionPoints;
     /**
      * Set the worksheet to read-only mode.
      * @returns {Promise<void>} A promise that resolves when the mode is set.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.setReadOnly();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * await fWorksheet.getWorksheetPermission().setReadOnly();
      * ```
      */
     setReadOnly(): Promise<void>;
@@ -210,20 +120,35 @@ export declare class FWorksheetPermission {
      * @returns {Promise<void>} A promise that resolves when the mode is set.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.setEditable();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * await fWorksheet.getWorksheetPermission().setEditable();
      * ```
      */
     setEditable(): Promise<void>;
+    /**
+     * Set a specific permission point for the worksheet.
+     * Automatically creates worksheet protection if not already protected.
+     * @param {WorksheetPermissionPoint} point The permission point to set.
+     * @param {boolean} value The value to set (true = allowed, false = denied).
+     * @returns {Promise<void>} A promise that resolves when the point is set.
+     * @example
+     * ```ts
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const permission = fWorksheet.getWorksheetPermission();
+     * await permission.setPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow, false);
+     * ```
+     */
+    setPoint(point: WorksheetPermissionPoint, value: boolean): Promise<void>;
     /**
      * Check if the worksheet is editable.
      * @returns {boolean} true if the worksheet can be edited, false otherwise.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * if (permission?.canEdit()) {
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * if (fWorksheet.getWorksheetPermission().canEdit()) {
      *   console.log('Worksheet is editable');
      * }
      * ```
@@ -236,50 +161,53 @@ export declare class FWorksheetPermission {
      * @returns {boolean} true if the cell can be edited, false otherwise.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const canEdit = permission?.canEditCell(0, 0);
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * // Check if cell C3 can be edited
+     * const fRange = fWorksheet.getRange('C3');
+     * const canEdit = fWorksheet.getWorksheetPermission().canEditCell(fRange.getRow(), fRange.getColumn());
      * console.log(canEdit);
      * ```
      */
     canEditCell(row: number, col: number): boolean;
     /**
-     * Check if a specific cell can be viewed.
-     * @param {number} _row Row index (unused, for API consistency).
-     * @param {number} _col Column index (unused, for API consistency).
-     * @returns {boolean} true if the cell can be viewed, false otherwise.
+     * Check if the worksheet is viewable.
+     * @returns {boolean} true if the worksheet can be viewed, false otherwise.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const canView = permission?.canViewCell(0, 0);
-     * console.log(canView);
-     * ```
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * if (fWorksheet.getWorksheetPermission().canView()) {
+     *   console.log('Worksheet is viewable');
+     * }
      */
-    canViewCell(_row: number, _col: number): boolean;
+    canView(): boolean;
     /**
-     * Set a specific permission point for the worksheet.
-     * Automatically creates worksheet protection if not already protected.
-     * @param {WorksheetPermissionPoint} point The permission point to set.
-     * @param {boolean} value The value to set (true = allowed, false = denied).
-     * @returns {Promise<void>} A promise that resolves when the point is set.
+     * Check if a specific cell can be viewed.
+     * @param {number} row Row index.
+     * @param {number} col Column index.
+     * @returns {boolean} true if the cell can be viewed, false otherwise.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.setPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow, false);
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * // Check if cell C3 can be viewed
+     * const fRange = fWorksheet.getRange('C3');
+     * const canView = fWorksheet.getWorksheetPermission().canViewCell(fRange.getRow(), fRange.getColumn());
+     * console.log(canView);
      * ```
      */
-    setPoint(point: WorksheetPermissionPoint, value: boolean): Promise<void>;
+    canViewCell(row: number, col: number): boolean;
     /**
      * Get the value of a specific permission point.
      * @param {WorksheetPermissionPoint} point The permission point to query.
      * @returns {boolean} true if allowed, false if denied.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const canInsertRow = permission?.getPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow);
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const permission = fWorksheet.getWorksheetPermission();
+     * const canInsertRow = permission.getPoint(univerAPI.Enum.WorksheetPermissionPoint.InsertRow);
      * console.log(canInsertRow);
      * ```
      */
@@ -289,9 +217,9 @@ export declare class FWorksheetPermission {
      * @returns {WorksheetPermissionSnapshot} An object containing all permission point values.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const snapshot = permission?.getSnapshot();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const snapshot = fWorksheet.getWorksheetPermission().getSnapshot();
      * console.log(snapshot);
      * ```
      */
@@ -320,16 +248,16 @@ export declare class FWorksheetPermission {
      * @returns {Promise<FRangeProtectionRule[]>} Array of created protection rules.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const rules = await permission?.protectRanges([
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const rules = await fWorksheet.getWorksheetPermission().protectRanges([
      *   {
-     *     ranges: [worksheet.getRange('A1:B2')],
-     *     options: { name: 'Protected Area 1', allowEdit: false, allowViewByOthers: true }
+     *     ranges: [fWorksheet.getRange('A1:B2')],
+     *     options: { name: 'Protected Area 1', allowedUsers: ['user1', 'user2'], allowViewByOthers: true }
      *   },
      *   {
-     *     ranges: [worksheet.getRange('C3:D4')],
-     *     options: { name: 'Protected Area 2', allowEdit: true, allowViewByOthers: false }
+     *     ranges: [fWorksheet.getRange('C3:D4')],
+     *     options: { name: 'Protected Area 2', allowViewByOthers: false }
      *   }
      * ]);
      * console.log(rules);
@@ -339,68 +267,52 @@ export declare class FWorksheetPermission {
         ranges: FRange[];
         options?: IRangeProtectionOptions;
     }>): Promise<FRangeProtectionRule[]>;
-    /**
-     * Determine view state from options
-     * @private
-     */
-    private _determineViewState;
-    /**
-     * Determine edit state from options
-     * @private
-     */
-    private _determineEditState;
-    /**
-     * Set permission points based on options (for local runtime control)
-     * @private
-     */
-    private _setPermissionPoints;
-    /**
-     * Set a single permission point
-     * @private
-     */
-    private _setPermissionPoint;
     /**
      * Remove multiple protection rules at once.
      * @param {string[]} ruleIds Array of rule IDs to remove.
      * @returns {Promise<void>} A promise that resolves when the rules are removed.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * await permission?.unprotectRules(['rule1', 'rule2']);
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const worksheetPermission = fWorksheet.getWorksheetPermission();
+     * const rules = await worksheetPermission.listRangeProtectionRules();
+     * // Unprotect the first rule as an example
+     * if (rules.length > 0) {
+     *   const result = await worksheetPermission.unprotectRules([rules[0].id]);
+     *   console.log(result);
+     * }
      * ```
      */
-    unprotectRules(ruleIds: string[]): Promise<void>;
+    unprotectRules(ruleIds: string[]): Promise<boolean>;
     /**
      * List all range protection rules for the worksheet.
      * @returns {Promise<FRangeProtectionRule[]>} Array of protection rules.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const rules = await permission?.listRangeProtectionRules();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * const rules = await fWorksheet.getWorksheetPermission().listRangeProtectionRules();
      * console.log(rules);
      * ```
      */
-    listRangeProtectionRules(): Promise<FRangeProtectionRule[]>;
+    listRangeProtectionRules(options?: {
+        ignoreCollaborators?: boolean;
+    }): Promise<FRangeProtectionRule[]>;
     /**
-     * Subscribe to permission changes (simplified interface for users not familiar with RxJS).
-     * @param {Function} listener Callback function to be called when permissions change.
-     * @returns {UnsubscribeFn} Unsubscribe function.
+     * Debug cell permission information.
+     * @param {number} row Row index.
+     * @param {number} col Column index.
+     * @returns {FRangeProtectionRule | undefined} Debug information about which rules affect this cell, or null if no rules apply.
      * @example
      * ```ts
-     * const worksheet = univerAPI.getActiveWorkbook()?.getActiveSheet();
-     * const permission = worksheet?.getWorksheetPermission();
-     * const unsubscribe = permission?.subscribe((snapshot) => {
-     *   console.log('Permission changed:', snapshot);
-     * });
-     * // Later, to stop listening:
-     * unsubscribe?.();
+     * const fWorkbook = univerAPI.getActiveWorkbook();
+     * const fWorksheet = fWorkbook.getActiveSheet();
+     * // Get debug info for cell C3
+     * const fRange = fWorksheet.getRange('C3');
+     * const debugInfo = await fWorksheet.getWorksheetPermission().debugCellPermission(fRange.getRow(), fRange.getColumn());
+     * console.log(debugInfo);
      * ```
      */
-    subscribe(listener: (snapshot: WorksheetPermissionSnapshot) => void): UnsubscribeFn;
-    /**
-     * Clean up resources
-     */
-    dispose(): void;
+    debugCellPermission(row: number, col: number): Promise<FRangeProtectionRule | undefined>;
 }

package/lib/types/facade/permission/permission-types.d.ts

@@ -13,8 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IUser } from '@univerjs/protocol';
-import type { Observable } from 'rxjs';
 /**
  * ========================
  * Basic Types / Enums
@@ -28,23 +26,14 @@ export declare enum UnitRole {
     Editor = 1,
     Owner = 2
 }
-/**
- * User reference information
- */
-export interface IUserRef {
-    /** User ID (defined by host system) */
-    id: string;
-    /** Display name */
-    displayName?: string;
-    /** Email address */
-    email?: string;
+export interface ICollaboratorUser {
+    userID: string;
+    name: string;
+    avatar: string;
 }
-/**
- * Collaborator information
- */
 export interface ICollaborator {
     /** User information */
-    user: IUserRef;
+    user: ICollaboratorUser;
     /** Role */
     role: UnitRole;
 }
@@ -173,10 +162,6 @@ export type WorksheetPermissionSnapshot = Record<WorksheetPermissionPoint, boole
  * Range permission snapshot (state of all permission points)
  */
 export type RangePermissionSnapshot = Record<RangePermissionPoint, boolean>;
-/**
- * Unsubscribe function type
- */
-export type UnsubscribeFn = () => void;
 /**
  * ========================
  * Worksheet Protection Configuration
@@ -186,8 +171,15 @@ export type UnsubscribeFn = () => void;
  * Worksheet protection options configuration
  */
 export interface IWorksheetProtectionOptions {
-    /** Whitelist of users allowed to edit; empty means only owner */
+    /**
+     * Specifies users allowed to edit this worksheet; if not specified, defaults to only the owner having edit permission.
+     */
     allowedUsers?: string[];
+    /**
+     * Whether to allow others to view this range.
+     * @default true
+     */
+    allowViewByOthers?: boolean;
     /** Protection name for UI display */
     name?: string;
     /** Custom metadata */
@@ -202,108 +194,20 @@ export interface IWorksheetProtectionOptions {
  * Range protection options configuration
  */
 export interface IRangeProtectionOptions {
-    /** Whether to allow current user to edit (default false = protected, not editable) */
-    allowEdit?: boolean;
-    /** Whitelist of users allowed to edit; empty means determined by role or global policy */
+    /**
+     * Specifies users allowed to edit this range; if not specified, defaults to only the owner having edit permission.
+     */
     allowedUsers?: string[];
+    /**
+     * Whether to allow others to view this range.
+     * @default true
+     */
     allowViewByOthers?: boolean;
     /** Rule name for UI display and management */
     name?: string;
     /** Custom metadata (logs, tags, etc.) */
     metadata?: Record<string, unknown>;
 }
-/**
- * Cell permission debug rule information
- */
-export interface ICellPermissionDebugRuleInfo {
-    ruleId: string;
-    /** Range reference string list, e.g., ['A1:B10', 'D1:D5'] */
-    rangeRefs: string[];
-    options: IRangeProtectionOptions;
-}
-/**
- * ========================
- * Facade: WorkbookPermission
- * ========================
- */
-/**
- * Workbook-level permission Facade interface
- */
-export interface IWorkbookPermission {
-    /**
-     * High-level mode setting: By Owner / Editor / Viewer / Commenter semantics
-     * Internally automatically combines multiple WorkbookPermissionPoints
-     */
-    setMode(mode: WorkbookMode): Promise<void>;
-    /** Shortcut: Set workbook to read-only (equivalent to setMode('viewer')) */
-    setReadOnly(): Promise<void>;
-    /** Shortcut: Set workbook to editable (equivalent to setMode('editor') or owner subset) */
-    setEditable(): Promise<void>;
-    /** Whether current user can edit this workbook (calculated from combined permissions) */
-    canEdit(): boolean;
-    /**
-     * Collaborator management (wraps IAuthzIoService)
-     */
-    /** Batch set collaborators (replace mode, overwrites existing collaborator list) */
-    setCollaborators(collaborators: Array<{
-        user: IUser;
-        role: UnitRole;
-    }>): Promise<void>;
-    /** Add a single collaborator */
-    addCollaborator(user: IUser, role: UnitRole): Promise<void>;
-    /** Update collaborator role and information */
-    updateCollaborator(user: IUser, role: UnitRole): Promise<void>;
-    /** Remove collaborator */
-    removeCollaborator(userId: string): Promise<void>;
-    /** Batch remove collaborators */
-    removeCollaborators(userIds: string[]): Promise<void>;
-    /** List all collaborators */
-    listCollaborators(): Promise<ICollaborator[]>;
-    /**
-     * Low-level point operations: Directly set boolean value of a WorkbookPermissionPoint
-     */
-    setPoint(point: WorkbookPermissionPoint, value: boolean): Promise<void>;
-    /** Read current value of a point (synchronous, reads from local state) */
-    getPoint(point: WorkbookPermissionPoint): boolean;
-    /** Get snapshot of all current points */
-    getSnapshot(): WorkbookPermissionSnapshot;
-    /**
-     * ========================
-     * RxJS Observable Reactive Interface
-     * ========================
-     */
-    /**
-     * Permission snapshot change stream (BehaviorSubject, immediately provides current state on subscription)
-     * Triggers when any permission point changes
-     */
-    readonly permission$: Observable<WorkbookPermissionSnapshot>;
-    /**
-     * Single permission point change stream
-     * For scenarios that only care about specific permission point changes
-     */
-    readonly pointChange$: Observable<{
-        point: WorkbookPermissionPoint;
-        value: boolean;
-        oldValue: boolean;
-    }>;
-    /**
-     * Collaborator change stream
-     */
-    readonly collaboratorChange$: Observable<{
-        type: 'add' | 'update' | 'delete';
-        collaborator: ICollaborator;
-    }>;
-    /**
-     * Compatibility method: Simplified subscription (for users unfamiliar with RxJS)
-     * Internally implemented based on permission$ Observable
-     */
-    subscribe(listener: (snapshot: WorkbookPermissionSnapshot) => void): UnsubscribeFn;
-}
-/**
- * ========================
- * Facade: WorksheetPermission
- * ========================
- */
 /**
  * Worksheet permission configuration
  */
@@ -318,12 +222,3 @@ export interface IWorksheetPermissionConfig {
         options?: IRangeProtectionOptions;
     }>;
 }
-/**
- * ========================
- * Facade: RangePermission
- * ========================
- */
-export interface ICellPermissionDebugInfo {
-    permissionId: string;
-    ruleId: string;
-}