@codingame/monaco-vscode-api 4.4.1 → 4.5.0

package/vscode/src/vs/workbench/services/editor/common/editorGroupsService.service.d.ts

@@ -0,0 +1,50 @@
+import { ServiceIdentifier } from '../../../../platform/instantiation/common/instantiation.js';
+import { Event } from '../../../../base/common/event.js';
+import { GroupIdentifier, IEditorPartOptions, IEditorPartOptionsChangeEvent } from '../../../common/editor.js';
+import { IRectangle } from '../../../../platform/window/common/window.js';
+import { IEditorGroupsContainer, IAuxiliaryEditorPartCreateEvent, IEditorPart, IEditorGroup, IAuxiliaryEditorPart } from './editorGroupsService.js';
+
+declare const IEditorGroupsService: ServiceIdentifier<IEditorGroupsService>;
+/**
+* The main service to interact with editor groups across all opened editor parts.
+*/
+interface IEditorGroupsService extends IEditorGroupsContainer {
+    readonly _serviceBrand: undefined;
+    /**
+    * An event for when a new auxiliary editor part is created.
+    */
+    readonly onDidCreateAuxiliaryEditorPart: Event<IAuxiliaryEditorPartCreateEvent>;
+    /**
+    * Provides access to the main window editor part.
+    */
+    readonly mainPart: IEditorPart;
+    /**
+    * Provides access to all editor parts.
+    */
+    readonly parts: ReadonlyArray<IEditorPart>;
+    /**
+    * Get the editor part that contains the group with the provided identifier.
+    */
+    getPart(group: IEditorGroup | GroupIdentifier): IEditorPart;
+    /**
+    * Get the editor part that is rooted in the provided container.
+    */
+    getPart(container: unknown): IEditorPart;
+    /**
+    * Access the options of the editor part.
+    */
+    readonly partOptions: IEditorPartOptions;
+    /**
+    * An event that notifies when editor part options change.
+    */
+    readonly onDidChangeEditorPartOptions: Event<IEditorPartOptionsChangeEvent>;
+    /**
+    * Opens a new window with a full editor part instantiated
+    * in there at the optional position and size on screen.
+    */
+    createAuxiliaryEditorPart(options?: {
+        bounds?: Partial<IRectangle>;
+    }): Promise<IAuxiliaryEditorPart>;
+}
+
+export { IEditorGroupsService };

package/vscode/src/vs/workbench/services/editor/common/editorGroupsService.service.js

@@ -0,0 +1,3 @@
+import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
+const IEditorGroupsService = ( createDecorator('editorGroupsService'));
+export { IEditorGroupsService };

package/vscode/src/vs/workbench/services/editor/common/editorResolverService.d.ts

@@ -1,12 +1,7 @@
-import { ServiceIdentifier } from '../../../../platform/instantiation/common/instantiation.js';
-import { IRelativePattern } from '../../../../base/common/glob.js';
-import { Event } from '../../../../base/common/event.js';
-import { IDisposable } from '../../../../base/common/lifecycle.js';
 import { URI } from '../../../../base/common/uri.js';
 import { IResourceEditorInput, ITextResourceEditorInput } from '../../../../platform/editor/common/editor.js';
-import { IUntypedEditorInput, EditorInputWithOptionsAndGroup, IUntitledTextResourceEditorInput, IResourceDiffEditorInput, IResourceMultiDiffEditorInput, IResourceMergeEditorInput, EditorInputWithOptions } from '../../../common/editor.js';
+import { EditorInputWithOptionsAndGroup, IUntitledTextResourceEditorInput, IResourceDiffEditorInput, IResourceMultiDiffEditorInput, IResourceMergeEditorInput, EditorInputWithOptions } from '../../../common/editor.js';
 import { IEditorGroup } from './editorGroupsService.js';
-import { PreferredGroup } from './editorService.js';
 import { AtLeastOne } from '../../../../base/common/types.js';
 
 type EditorAssociation = {
@@ -62,59 +57,4 @@ type EditorInputFactories = {
 };
 type EditorInputFactoryObject = AtLeastOne<EditorInputFactories>;
 
-declare const IEditorResolverService: ServiceIdentifier<IEditorResolverService>;
-interface IEditorResolverService {
-    readonly _serviceBrand: undefined;
-    /**
-     * Given a resource finds the editor associations that match it from the user's settings
-     * @param resource The resource to match
-     * @return The matching associations
-     */
-    getAssociationsForResource(resource: URI): EditorAssociations;
-    /**
-     * Updates the user's association to include a specific editor ID as a default for the given glob pattern
-     * @param globPattern The glob pattern (must be a string as settings don't support relative glob)
-     * @param editorID The ID of the editor to make a user default
-     */
-    updateUserAssociations(globPattern: string, editorID: string): void;
-    /**
-     * Emitted when an editor is registered or unregistered.
-     */
-    readonly onDidChangeEditorRegistrations: Event<void>;
-    /**
-     * Given a callback, run the callback pausing the registration emitter
-     */
-    bufferChangeEvents(callback: Function): void;
-    /**
-     * Registers a specific editor. Editors with the same glob pattern and ID will be grouped together by the resolver.
-     * This allows for registration of the factories in different locations
-     * @param globPattern The glob pattern for this registration
-     * @param editorInfo Information about the registration
-     * @param options Specific options which apply to this registration
-     * @param editorFactoryObject The editor input factory functions
-     */
-    registerEditor(globPattern: string | IRelativePattern, editorInfo: RegisteredEditorInfo, options: RegisteredEditorOptions, editorFactoryObject: EditorInputFactoryObject): IDisposable;
-    /**
-     * Given an editor resolves it to the suitable ResolvedEitor based on user extensions, settings, and built-in editors
-     * @param editor The editor to resolve
-     * @param preferredGroup The group you want to open the editor in
-     * @returns An EditorInputWithOptionsAndGroup if there is an available editor or a status of how to proceed
-     */
-    resolveEditor(editor: IUntypedEditorInput, preferredGroup: PreferredGroup | undefined): Promise<ResolvedEditor>;
-    /**
-     * Given a resource returns all the editor ids that match that resource. If there is exclusive editor we return an empty array
-     * @param resource The resource
-     * @returns A list of editor ids
-     */
-    getEditors(resource: URI): RegisteredEditorInfo[];
-    /**
-     * A set of all the editors that are registered to the editor resolver.
-     */
-    getEditors(): RegisteredEditorInfo[];
-    /**
-     * Get a complete list of editor associations.
-     */
-    getAllUserAssociations(): EditorAssociations;
-}
-
-export { type DiffEditorInputFactoryFunction, type EditorAssociation, type EditorAssociations, type EditorInputFactoryFunction, type EditorInputFactoryObject, IEditorResolverService, type MergeEditorInputFactoryFunction, type MultiDiffEditorInputFactoryFunction, type RegisteredEditorInfo, type RegisteredEditorOptions, RegisteredEditorPriority, type ResolvedEditor, ResolvedStatus, type UntitledEditorInputFactoryFunction };
+export { type DiffEditorInputFactoryFunction, type EditorAssociation, type EditorAssociations, type EditorInputFactoryFunction, type EditorInputFactoryObject, type MergeEditorInputFactoryFunction, type MultiDiffEditorInputFactoryFunction, type RegisteredEditorInfo, type RegisteredEditorOptions, RegisteredEditorPriority, type ResolvedEditor, ResolvedStatus, type UntitledEditorInputFactoryFunction };

package/vscode/src/vs/workbench/services/editor/common/editorResolverService.js

@@ -5,9 +5,7 @@ import { basename } from '../../../../base/common/resources.js';
 import { localizeWithPath } from '../../../../nls.js';
 import { workbenchConfigurationNodeBase } from '../../../common/configuration.js';
 import { Extensions } from '../../../../platform/configuration/common/configurationRegistry.js';
-import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
 import { Registry } from '../../../../platform/registry/common/platform.js';
-const IEditorResolverService = ( createDecorator('editorResolverService'));
 const editorsAssociationsSettingId = 'workbench.editorAssociations';
 const configurationRegistry = ( Registry.as(Extensions.Configuration));
 const editorAssociationsConfigurationNode = {
@@ -61,4 +59,4 @@ function globMatchesResource(globPattern, resource) {
     const target = matchOnPath ? `${resource.scheme}:${resource.path}` : basename(resource);
     return match(typeof globPattern === 'string' ? globPattern.toLowerCase() : globPattern, target.toLowerCase());
 }
-export { IEditorResolverService, RegisteredEditorPriority, editorsAssociationsSettingId, globMatchesResource, priorityToRank };
+export { RegisteredEditorPriority, editorsAssociationsSettingId, globMatchesResource, priorityToRank };

package/vscode/src/vs/workbench/services/editor/common/editorResolverService.service.d.ts

@@ -0,0 +1,65 @@
+import { ServiceIdentifier } from '../../../../platform/instantiation/common/instantiation.js';
+import { IRelativePattern } from '../../../../base/common/glob.js';
+import { Event } from '../../../../base/common/event.js';
+import { IDisposable } from '../../../../base/common/lifecycle.js';
+import { URI } from '../../../../base/common/uri.js';
+import { IUntypedEditorInput } from '../../../common/editor.js';
+import { PreferredGroup } from './editorService.js';
+import { EditorAssociations, RegisteredEditorInfo, RegisteredEditorOptions, EditorInputFactoryObject, ResolvedEditor } from './editorResolverService.js';
+
+declare const IEditorResolverService: ServiceIdentifier<IEditorResolverService>;
+interface IEditorResolverService {
+    readonly _serviceBrand: undefined;
+    /**
+    * Given a resource finds the editor associations that match it from the user's settings
+    * @param resource The resource to match
+    * @return The matching associations
+    */
+    getAssociationsForResource(resource: URI): EditorAssociations;
+    /**
+    * Updates the user's association to include a specific editor ID as a default for the given glob pattern
+    * @param globPattern The glob pattern (must be a string as settings don't support relative glob)
+    * @param editorID The ID of the editor to make a user default
+    */
+    updateUserAssociations(globPattern: string, editorID: string): void;
+    /**
+    * Emitted when an editor is registered or unregistered.
+    */
+    readonly onDidChangeEditorRegistrations: Event<void>;
+    /**
+    * Given a callback, run the callback pausing the registration emitter
+    */
+    bufferChangeEvents(callback: Function): void;
+    /**
+    * Registers a specific editor. Editors with the same glob pattern and ID will be grouped together by the resolver.
+    * This allows for registration of the factories in different locations
+    * @param globPattern The glob pattern for this registration
+    * @param editorInfo Information about the registration
+    * @param options Specific options which apply to this registration
+    * @param editorFactoryObject The editor input factory functions
+    */
+    registerEditor(globPattern: string | IRelativePattern, editorInfo: RegisteredEditorInfo, options: RegisteredEditorOptions, editorFactoryObject: EditorInputFactoryObject): IDisposable;
+    /**
+    * Given an editor resolves it to the suitable ResolvedEitor based on user extensions, settings, and built-in editors
+    * @param editor The editor to resolve
+    * @param preferredGroup The group you want to open the editor in
+    * @returns An EditorInputWithOptionsAndGroup if there is an available editor or a status of how to proceed
+    */
+    resolveEditor(editor: IUntypedEditorInput, preferredGroup: PreferredGroup | undefined): Promise<ResolvedEditor>;
+    /**
+    * Given a resource returns all the editor ids that match that resource. If there is exclusive editor we return an empty array
+    * @param resource The resource
+    * @returns A list of editor ids
+    */
+    getEditors(resource: URI): RegisteredEditorInfo[];
+    /**
+    * A set of all the editors that are registered to the editor resolver.
+    */
+    getEditors(): RegisteredEditorInfo[];
+    /**
+    * Get a complete list of editor associations.
+    */
+    getAllUserAssociations(): EditorAssociations;
+}
+
+export { IEditorResolverService };

package/vscode/src/vs/workbench/services/editor/common/editorResolverService.service.js

@@ -0,0 +1,3 @@
+import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
+const IEditorResolverService = ( createDecorator('editorResolverService'));
+export { IEditorResolverService };

package/vscode/src/vs/workbench/services/editor/common/editorService.d.ts

@@ -1,13 +1,7 @@
-import { ServiceIdentifier } from '../../../../platform/instantiation/common/instantiation.js';
-import { IResourceEditorInput, ITextResourceEditorInput, IEditorOptions, IResourceEditorInputIdentifier } from '../../../../platform/editor/common/editor.js';
-import { IEditorWillOpenEvent, IEditorCloseEvent, IVisibleEditorPane, EditorsOrder, IEditorIdentifier, GroupIdentifier, IEditorPane, IUntitledTextResourceEditorInput, IResourceDiffEditorInput, ITextDiffEditorPane, IUntypedEditorInput, IFindEditorOptions, IRevertOptions, ISaveOptions } from '../../../common/editor.js';
+import { GroupIdentifier, ISaveOptions, IUntypedEditorInput, IRevertOptions } from '../../../common/editor.js';
 import { EditorInput } from '../../../common/editor/editorInput.js';
-import { Event } from '../../../../base/common/event.js';
-import { IEditor, IDiffEditor } from '../../../../editor/common/editorCommon.js';
-import { IEditorGroup, ICloseEditorOptions, IEditorGroupsContainer } from './editorGroupsService.js';
-import { URI } from '../../../../base/common/uri.js';
+import { IEditorGroup } from './editorGroupsService.js';
 import { IGroupModelChangeEvent } from '../../../common/editor/editorGroupModel.js';
-import { DisposableStore } from '../../../../base/common/lifecycle.js';
 
 /**
  * Open an editor in the currently active group.
@@ -91,206 +85,4 @@ interface IEditorsChangeEvent {
     event: IGroupModelChangeEvent;
 }
 
-declare const IEditorService: ServiceIdentifier<IEditorService>;
-interface IEditorService {
-    readonly _serviceBrand: undefined;
-    /**
-     * Emitted when the currently active editor changes.
-     *
-     * @see {@link IEditorService.activeEditorPane}
-     */
-    readonly onDidActiveEditorChange: Event<void>;
-    /**
-     * Emitted when any of the current visible editors changes.
-     *
-     * @see {@link IEditorService.visibleEditorPanes}
-     */
-    readonly onDidVisibleEditorsChange: Event<void>;
-    /**
-     * An aggregated event for any change to any editor across
-     * all groups.
-     */
-    readonly onDidEditorsChange: Event<IEditorsChangeEvent>;
-    /**
-     * Emitted when an editor is about to open.
-     */
-    readonly onWillOpenEditor: Event<IEditorWillOpenEvent>;
-    /**
-     * Emitted when an editor is closed.
-     */
-    readonly onDidCloseEditor: Event<IEditorCloseEvent>;
-    /**
-     * The currently active editor pane or `undefined` if none. The editor pane is
-     * the workbench container for editors of any kind.
-     *
-     * @see {@link IEditorService.activeEditor} for access to the active editor input
-     */
-    readonly activeEditorPane: IVisibleEditorPane | undefined;
-    /**
-     * The currently active editor or `undefined` if none. An editor is active when it is
-     * located in the currently active editor group. It will be `undefined` if the active
-     * editor group has no editors open.
-     */
-    readonly activeEditor: EditorInput | undefined;
-    /**
-     * The currently active text editor control or `undefined` if there is currently no active
-     * editor or the active editor widget is neither a text nor a diff editor.
-     *
-     * @see {@link IEditorService.activeEditor}
-     */
-    readonly activeTextEditorControl: IEditor | IDiffEditor | undefined;
-    /**
-     * The currently active text editor language id or `undefined` if there is currently no active
-     * editor or the active editor control is neither a text nor a diff editor. If the active
-     * editor is a diff editor, the modified side's language id will be taken.
-     */
-    readonly activeTextEditorLanguageId: string | undefined;
-    /**
-     * All editor panes that are currently visible across all editor groups.
-     *
-     * @see {@link IEditorService.visibleEditors} for access to the visible editor inputs
-     */
-    readonly visibleEditorPanes: readonly IVisibleEditorPane[];
-    /**
-     * All editors that are currently visible. An editor is visible when it is opened in an
-     * editor group and active in that group. Multiple editor groups can be opened at the same time.
-     */
-    readonly visibleEditors: readonly EditorInput[];
-    /**
-     * All text editor widgets that are currently visible across all editor groups. A text editor
-     * widget is either a text or a diff editor.
-     */
-    readonly visibleTextEditorControls: readonly (IEditor | IDiffEditor)[];
-    /**
-     * All editors that are opened across all editor groups in sequential order
-     * of appearance.
-     *
-     * This includes active as well as inactive editors in each editor group.
-     */
-    readonly editors: readonly EditorInput[];
-    /**
-     * The total number of editors that are opened either inactive or active.
-     */
-    readonly count: number;
-    /**
-     * All editors that are opened across all editor groups with their group
-     * identifier.
-     *
-     * @param order the order of the editors to use
-     * @param options whether to exclude sticky editors or not
-     */
-    getEditors(order: EditorsOrder, options?: {
-        excludeSticky?: boolean;
-    }): readonly IEditorIdentifier[];
-    /**
-     * Open an editor in an editor group.
-     *
-     * @param editor the editor to open
-     * @param options the options to use for the editor
-     * @param group the target group. If unspecified, the editor will open in the currently
-     * active group. Use `SIDE_GROUP` to open the editor in a new editor group to the side
-     * of the currently active group.
-     *
-     * @returns the editor that opened or `undefined` if the operation failed or the editor was not
-     * opened to be active.
-     */
-    openEditor(editor: IResourceEditorInput, group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE): Promise<IEditorPane | undefined>;
-    openEditor(editor: ITextResourceEditorInput | IUntitledTextResourceEditorInput, group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE): Promise<IEditorPane | undefined>;
-    openEditor(editor: IResourceDiffEditorInput, group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE): Promise<ITextDiffEditorPane | undefined>;
-    openEditor(editor: IUntypedEditorInput, group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE): Promise<IEditorPane | undefined>;
-    /**
-     * @deprecated using this method is a sign that your editor has not adopted the editor
-     * resolver yet. Please use `IEditorResolverService.registerEditor` to make your editor
-     * known to the workbench and then use untyped editor inputs for opening:
-     *
-     * ```ts
-     * editorService.openEditor({ resource });
-     * ```
-     *
-     * If you already have an `EditorInput` in hand and must use it for opening, use `group.openEditor`
-     * instead, via `IEditorGroupsService`.
-     */
-    openEditor(editor: EditorInput, options?: IEditorOptions, group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE): Promise<IEditorPane | undefined>;
-    /**
-     * Open editors in an editor group.
-     *
-     * @param editors the editors to open with associated options
-     * @param group the target group. If unspecified, the editor will open in the currently
-     * active group. Use `SIDE_GROUP` to open the editor in a new editor group to the side
-     * of the currently active group.
-     *
-     * @returns the editors that opened. The array can be empty or have less elements for editors
-     * that failed to open or were instructed to open as inactive.
-     */
-    openEditors(editors: IUntypedEditorInput[], group?: IEditorGroup | GroupIdentifier | SIDE_GROUP_TYPE | ACTIVE_GROUP_TYPE | AUX_WINDOW_GROUP_TYPE, options?: IOpenEditorsOptions): Promise<readonly IEditorPane[]>;
-    /**
-     * Replaces editors in an editor group with the provided replacement.
-     *
-     * @param replacements the editors to replace
-     * @param group the editor group
-     *
-     * @returns a promise that is resolved when the replaced active
-     * editor (if any) has finished loading.
-     */
-    replaceEditors(replacements: IUntypedEditorReplacement[], group: IEditorGroup | GroupIdentifier): Promise<void>;
-    /**
-     * Find out if the provided editor is opened in any editor group.
-     *
-     * Note: An editor can be opened but not actively visible.
-     *
-     * Note: This method will return `true` if a side by side editor
-     * is opened where the `primary` editor matches too.
-     */
-    isOpened(editor: IResourceEditorInputIdentifier): boolean;
-    /**
-     * Find out if the provided editor is visible in any editor group.
-     */
-    isVisible(editor: EditorInput): boolean;
-    /**
-     * Close an editor in a specific editor group.
-     */
-    closeEditor(editor: IEditorIdentifier, options?: ICloseEditorOptions): Promise<void>;
-    /**
-     * Close multiple editors in specific editor groups.
-     */
-    closeEditors(editors: readonly IEditorIdentifier[], options?: ICloseEditorOptions): Promise<void>;
-    /**
-     * This method will return an entry for each editor that reports
-     * a `resource` that matches the provided one in the group or
-     * across all groups.
-     *
-     * It is possible that multiple editors are returned in case the
-     * same resource is opened in different editors. To find the specific
-     * editor, use the `IResourceEditorInputIdentifier` as input.
-     */
-    findEditors(resource: URI, options?: IFindEditorOptions): readonly IEditorIdentifier[];
-    findEditors(editor: IResourceEditorInputIdentifier, options?: IFindEditorOptions): readonly IEditorIdentifier[];
-    /**
-     * Save the provided list of editors.
-     */
-    save(editors: IEditorIdentifier | IEditorIdentifier[], options?: ISaveEditorsOptions): Promise<ISaveEditorsResult>;
-    /**
-     * Save all editors.
-     */
-    saveAll(options?: ISaveAllEditorsOptions): Promise<ISaveEditorsResult>;
-    /**
-     * Reverts the provided list of editors.
-     *
-     * @returns `true` if all editors reverted and `false` otherwise.
-     */
-    revert(editors: IEditorIdentifier | IEditorIdentifier[], options?: IRevertOptions): Promise<boolean>;
-    /**
-     * Reverts all editors.
-     *
-     * @returns `true` if all editors reverted and `false` otherwise.
-     */
-    revertAll(options?: IRevertAllEditorsOptions): Promise<boolean>;
-    /**
-     * Create a scoped editor service that only operates on the provided
-     * editor group container. Use `main` to create a scoped editor service
-     * to the main editor group container of the main window.
-     */
-    createScoped(editorGroupsContainer: IEditorGroupsContainer | 'main', disposables: DisposableStore): IEditorService;
-}
-
-export { ACTIVE_GROUP, type ACTIVE_GROUP_TYPE, AUX_WINDOW_GROUP, type AUX_WINDOW_GROUP_TYPE, type IBaseSaveRevertAllEditorOptions, IEditorService, type IEditorsChangeEvent, type IOpenEditorsOptions, type IRevertAllEditorsOptions, type ISaveAllEditorsOptions, type ISaveEditorsOptions, type ISaveEditorsResult, type IUntypedEditorReplacement, type PreferredGroup, SIDE_GROUP, type SIDE_GROUP_TYPE };
+export { ACTIVE_GROUP, type ACTIVE_GROUP_TYPE, AUX_WINDOW_GROUP, type AUX_WINDOW_GROUP_TYPE, type IBaseSaveRevertAllEditorOptions, type IEditorsChangeEvent, type IOpenEditorsOptions, type IRevertAllEditorsOptions, type ISaveAllEditorsOptions, type ISaveEditorsOptions, type ISaveEditorsResult, type IUntypedEditorReplacement, type PreferredGroup, SIDE_GROUP, type SIDE_GROUP_TYPE };

package/vscode/src/vs/workbench/services/editor/common/editorService.js

@@ -1,6 +1,4 @@
-import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
 import { isEditorGroup } from './editorGroupsService.js';
-const IEditorService = ( createDecorator('editorService'));
 const ACTIVE_GROUP = -1;
 const SIDE_GROUP = -2;
 const AUX_WINDOW_GROUP = -3;
@@ -8,4 +6,4 @@ function isPreferredGroup(obj) {
     const candidate = obj;
     return typeof obj === 'number' || isEditorGroup(candidate);
 }
-export { ACTIVE_GROUP, AUX_WINDOW_GROUP, IEditorService, SIDE_GROUP, isPreferredGroup };
+export { ACTIVE_GROUP, AUX_WINDOW_GROUP, SIDE_GROUP, isPreferredGroup };