@theia/core 1.45.1 → 1.46.0-next.72

package/lib/browser/tree/tree-container.js

@@ -1,116 +1,116 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2017 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTreeContainer = exports.isTreeServices = void 0;
-const inversify_1 = require("inversify");
-const tree_widget_1 = require("./tree-widget");
-const tree_model_1 = require("./tree-model");
-const tree_1 = require("./tree");
-const tree_selection_1 = require("./tree-selection");
-const tree_selection_impl_1 = require("./tree-selection-impl");
-const tree_expansion_1 = require("./tree-expansion");
-const tree_navigation_1 = require("./tree-navigation");
-const tree_decorator_1 = require("./tree-decorator");
-const tree_search_1 = require("./tree-search");
-const fuzzy_search_1 = require("./fuzzy-search");
-const search_box_1 = require("./search-box");
-const search_box_debounce_1 = require("./search-box-debounce");
-const tree_focus_service_1 = require("./tree-focus-service");
-function isTreeServices(candidate) {
-    if (candidate) {
-        const maybeServices = candidate;
-        for (const key of Object.keys(maybeServices)) {
-            // This key is in both TreeProps and TreeContainerProps, so we have to handle it separately
-            if (key === 'search' && typeof maybeServices[key] === 'boolean') {
-                return false;
-            }
-            if (key in defaultImplementations) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-exports.isTreeServices = isTreeServices;
-function createTreeContainer(parent, props) {
-    const child = new inversify_1.Container({ defaultScope: 'Singleton' });
-    child.parent = parent;
-    const overrideServices = isTreeServices(props) ? props : { props: props };
-    for (const key of Object.keys(serviceIdentifiers)) {
-        if (key === 'props') {
-            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
-            child.bind(identifier).toConstantValue({
-                ...defaultImplementations.props,
-                ...service
-            });
-        }
-        else if (key === 'searchBoxFactory') {
-            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
-            child.bind(identifier).toFactory(context => service(context));
-        }
-        else {
-            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
-            child.bind(service).toSelf().inSingletonScope();
-            if (identifier !== service) {
-                child.bind(identifier).toService(service);
-            }
-        }
-    }
-    return child;
-}
-exports.createTreeContainer = createTreeContainer;
-function getServiceAndIdentifier(key, overrides) {
-    const override = overrides[key];
-    const service = override !== null && override !== void 0 ? override : defaultImplementations[key];
-    return {
-        service,
-        identifier: serviceIdentifiers[key]
-    };
-}
-const defaultSearchBoxFactoryFactory = () => options => {
-    const debounce = new search_box_debounce_1.SearchBoxDebounce(options);
-    return new search_box_1.SearchBox(options, debounce);
-};
-const defaultImplementations = {
-    tree: tree_1.TreeImpl,
-    selectionService: tree_selection_impl_1.TreeSelectionServiceImpl,
-    expansionService: tree_expansion_1.TreeExpansionServiceImpl,
-    navigationService: tree_navigation_1.TreeNavigationService,
-    model: tree_model_1.TreeModelImpl,
-    widget: tree_widget_1.TreeWidget,
-    search: tree_search_1.TreeSearch,
-    fuzzy: fuzzy_search_1.FuzzySearch,
-    decoratorService: tree_decorator_1.NoopTreeDecoratorService,
-    focusService: tree_focus_service_1.TreeFocusServiceImpl,
-    props: tree_widget_1.defaultTreeProps,
-    searchBoxFactory: defaultSearchBoxFactoryFactory,
-};
-const serviceIdentifiers = {
-    tree: tree_1.Tree,
-    selectionService: tree_selection_1.TreeSelectionService,
-    expansionService: tree_expansion_1.TreeExpansionService,
-    navigationService: tree_navigation_1.TreeNavigationService,
-    model: tree_model_1.TreeModel,
-    widget: tree_widget_1.TreeWidget,
-    props: tree_widget_1.TreeProps,
-    search: tree_search_1.TreeSearch,
-    fuzzy: fuzzy_search_1.FuzzySearch,
-    searchBoxFactory: search_box_1.SearchBoxFactory,
-    decoratorService: tree_decorator_1.TreeDecoratorService,
-    focusService: tree_focus_service_1.TreeFocusService
-};
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTreeContainer = exports.isTreeServices = void 0;
+const inversify_1 = require("inversify");
+const tree_widget_1 = require("./tree-widget");
+const tree_model_1 = require("./tree-model");
+const tree_1 = require("./tree");
+const tree_selection_1 = require("./tree-selection");
+const tree_selection_impl_1 = require("./tree-selection-impl");
+const tree_expansion_1 = require("./tree-expansion");
+const tree_navigation_1 = require("./tree-navigation");
+const tree_decorator_1 = require("./tree-decorator");
+const tree_search_1 = require("./tree-search");
+const fuzzy_search_1 = require("./fuzzy-search");
+const search_box_1 = require("./search-box");
+const search_box_debounce_1 = require("./search-box-debounce");
+const tree_focus_service_1 = require("./tree-focus-service");
+function isTreeServices(candidate) {
+    if (candidate) {
+        const maybeServices = candidate;
+        for (const key of Object.keys(maybeServices)) {
+            // This key is in both TreeProps and TreeContainerProps, so we have to handle it separately
+            if (key === 'search' && typeof maybeServices[key] === 'boolean') {
+                return false;
+            }
+            if (key in defaultImplementations) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+exports.isTreeServices = isTreeServices;
+function createTreeContainer(parent, props) {
+    const child = new inversify_1.Container({ defaultScope: 'Singleton' });
+    child.parent = parent;
+    const overrideServices = isTreeServices(props) ? props : { props: props };
+    for (const key of Object.keys(serviceIdentifiers)) {
+        if (key === 'props') {
+            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
+            child.bind(identifier).toConstantValue({
+                ...defaultImplementations.props,
+                ...service
+            });
+        }
+        else if (key === 'searchBoxFactory') {
+            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
+            child.bind(identifier).toFactory(context => service(context));
+        }
+        else {
+            const { service, identifier } = getServiceAndIdentifier(key, overrideServices);
+            child.bind(service).toSelf().inSingletonScope();
+            if (identifier !== service) {
+                child.bind(identifier).toService(service);
+            }
+        }
+    }
+    return child;
+}
+exports.createTreeContainer = createTreeContainer;
+function getServiceAndIdentifier(key, overrides) {
+    const override = overrides[key];
+    const service = override !== null && override !== void 0 ? override : defaultImplementations[key];
+    return {
+        service,
+        identifier: serviceIdentifiers[key]
+    };
+}
+const defaultSearchBoxFactoryFactory = () => options => {
+    const debounce = new search_box_debounce_1.SearchBoxDebounce(options);
+    return new search_box_1.SearchBox(options, debounce);
+};
+const defaultImplementations = {
+    tree: tree_1.TreeImpl,
+    selectionService: tree_selection_impl_1.TreeSelectionServiceImpl,
+    expansionService: tree_expansion_1.TreeExpansionServiceImpl,
+    navigationService: tree_navigation_1.TreeNavigationService,
+    model: tree_model_1.TreeModelImpl,
+    widget: tree_widget_1.TreeWidget,
+    search: tree_search_1.TreeSearch,
+    fuzzy: fuzzy_search_1.FuzzySearch,
+    decoratorService: tree_decorator_1.NoopTreeDecoratorService,
+    focusService: tree_focus_service_1.TreeFocusServiceImpl,
+    props: tree_widget_1.defaultTreeProps,
+    searchBoxFactory: defaultSearchBoxFactoryFactory,
+};
+const serviceIdentifiers = {
+    tree: tree_1.Tree,
+    selectionService: tree_selection_1.TreeSelectionService,
+    expansionService: tree_expansion_1.TreeExpansionService,
+    navigationService: tree_navigation_1.TreeNavigationService,
+    model: tree_model_1.TreeModel,
+    widget: tree_widget_1.TreeWidget,
+    props: tree_widget_1.TreeProps,
+    search: tree_search_1.TreeSearch,
+    fuzzy: fuzzy_search_1.FuzzySearch,
+    searchBoxFactory: search_box_1.SearchBoxFactory,
+    decoratorService: tree_decorator_1.TreeDecoratorService,
+    focusService: tree_focus_service_1.TreeFocusService
+};
 //# sourceMappingURL=tree-container.js.map

package/lib/browser/tree/tree-container.spec.d.ts

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=tree-container.spec.d.ts.map

package/lib/browser/tree/tree-container.spec.js

@@ -1,46 +1,46 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2022 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-const assert = require("assert");
-const inversify_1 = require("inversify");
-const tree_container_1 = require("./tree-container");
-const tree_search_1 = require("./tree-search");
-const tree_widget_1 = require("./tree-widget");
-describe('TreeContainer', () => {
-    describe('IsTreeServices should accurately distinguish TreeProps from TreeContainerProps', () => {
-        it('should assign search:boolean to TreeProps', () => {
-            assert((0, tree_container_1.isTreeServices)({
-                ...tree_widget_1.defaultTreeProps, search: true, multiSelect: true, globalSelection: true, contextMenuPath: ['so-contextual']
-            }) === false);
-        });
-        it('should assign search:not-a-boolean to TreeContainerProps', () => {
-            assert((0, tree_container_1.isTreeServices)({ search: tree_search_1.TreeSearch }) === true);
-        });
-        const nonDefault = { search: !tree_widget_1.defaultTreeProps.search, contextMenu: ['no-default-for-this'] };
-        it('should use props passed in as just props', () => {
-            const parent = new inversify_1.Container();
-            const child = (0, tree_container_1.createTreeContainer)(parent, nonDefault);
-            assert.deepStrictEqual(child.get(tree_widget_1.TreeProps), { ...tree_widget_1.defaultTreeProps, ...nonDefault });
-        });
-        it('should use props passed in as part of TreeContainerProps', () => {
-            const parent = new inversify_1.Container();
-            const child = (0, tree_container_1.createTreeContainer)(parent, { props: nonDefault });
-            assert.deepStrictEqual(child.get(tree_widget_1.TreeProps), { ...tree_widget_1.defaultTreeProps, ...nonDefault });
-        });
-    });
-});
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2022 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = require("assert");
+const inversify_1 = require("inversify");
+const tree_container_1 = require("./tree-container");
+const tree_search_1 = require("./tree-search");
+const tree_widget_1 = require("./tree-widget");
+describe('TreeContainer', () => {
+    describe('IsTreeServices should accurately distinguish TreeProps from TreeContainerProps', () => {
+        it('should assign search:boolean to TreeProps', () => {
+            assert((0, tree_container_1.isTreeServices)({
+                ...tree_widget_1.defaultTreeProps, search: true, multiSelect: true, globalSelection: true, contextMenuPath: ['so-contextual']
+            }) === false);
+        });
+        it('should assign search:not-a-boolean to TreeContainerProps', () => {
+            assert((0, tree_container_1.isTreeServices)({ search: tree_search_1.TreeSearch }) === true);
+        });
+        const nonDefault = { search: !tree_widget_1.defaultTreeProps.search, contextMenu: ['no-default-for-this'] };
+        it('should use props passed in as just props', () => {
+            const parent = new inversify_1.Container();
+            const child = (0, tree_container_1.createTreeContainer)(parent, nonDefault);
+            assert.deepStrictEqual(child.get(tree_widget_1.TreeProps), { ...tree_widget_1.defaultTreeProps, ...nonDefault });
+        });
+        it('should use props passed in as part of TreeContainerProps', () => {
+            const parent = new inversify_1.Container();
+            const child = (0, tree_container_1.createTreeContainer)(parent, { props: nonDefault });
+            assert.deepStrictEqual(child.get(tree_widget_1.TreeProps), { ...tree_widget_1.defaultTreeProps, ...nonDefault });
+        });
+    });
+});
 //# sourceMappingURL=tree-container.spec.js.map

package/lib/browser/tree/tree-decorator.d.ts

@@ -1,144 +1,144 @@
-import { Tree, TreeNode } from './tree';
-import { Event, Emitter, Disposable, DisposableCollection, MaybePromise } from '../../common';
-import { WidgetDecoration } from '../widget-decoration';
-/**
- * The {@link TreeDecorator} allows adapting the look and the style of the tree items within a widget. Changes are reflected in
- * the form of `decoration data`. This `decoration data` is a map storing {@link TreeDecoration.Data} for affected tree nodes (using the unique node id as key).
- * It is important to notice that there is no common contribution point for `TreeDecorators`. Instead, each {@link TreeDecoratorService} is
- * supposed to declare its own contribution provider for `TreeDecorators`.
- *
- * ### Example usage
- * A simple tree decorator that changes the background color of each tree node to `red`.
- *
- * ```typescript
- * @injectable()
- * export class MyTreeDecorator implements TreeDecorator {
- *     id = 'myTreeDecorator';
- *
- *     protected readonly emitter = new Emitter<(tree: Tree) => Map<string, TreeDecoration.Data>>();
- *
- *     get onDidChangeDecorations(): Event<(tree: Tree) => Map<string, TreeDecoration.Data>> {
- *         return this.emitter.event;
- *     }
- *
- *     decorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data>> {
- *         const result = new Map();
- *
- *         if (tree.root === undefined) {
- *             return result;
- *         }
- *         for (const treeNode of new DepthFirstTreeIterator(tree.root)) {
- *             result.set(treeNode.id,<TreeDecoration.Data>{backgroundColor:'red'})
- *         }
- *         return result;
- *     }
- * }
- * ```
- */
-export interface TreeDecorator {
-    /**
-     * The unique identifier of the decorator. Ought to be unique in the application.
-     */
-    readonly id: string;
-    /**
-     * Fired when this decorator has calculated all the `decoration data` for the tree nodes.
-     */
-    readonly onDidChangeDecorations: Event<(tree: Tree) => Map<string, TreeDecoration.Data>>;
-    /**
-     * Computes the current `decoration data` for the given tree. Might return a promise if the computation is handled asynchronously.
-     *
-     * @param tree the tree to decorate.
-     *
-     * @returns (a promise of) a map containing the current {@linkTreeDecoration.Data} for each node. Keys are the unique identifier of the tree nodes.
-     */
-    decorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data>>;
-}
-export declare const TreeDecoratorService: unique symbol;
-/**
- * The {@link TreeDecoratorService} manages a set of known {link TreeDecorator}s and emits events when
- * any of the known decorators has changes. Typically, a `TreeDecoratorService` provides a contribution point that can be used to
- * register {@link TreeDecorator}s exclusively for this service.
- *
- * ### Example usage
- * ```typescript
- * export const MyTreeDecorator = Symbol('MyTreeDecorator');
- *
- * @injectable()
- * export class MyDecorationService extends AbstractTreeDecoratorService {
- *     constructor(@inject(ContributionProvider) @named(MyTreeDecorator) protected readonly contributions: ContributionProvider<TreeDecorator>) {
- *         super(contributions.getContributions());
- *     }
- * }
- * ```
- */
-export interface TreeDecoratorService extends Disposable {
-    /**
-     * Fired when any of the available tree decorators has changes.
-     */
-    readonly onDidChangeDecorations: Event<void>;
-    /**
-     * Computes the decorations for the tree based on the actual state of this decorator service.
-     *
-     * @param tree the tree to decorate
-     *
-     * @returns (a promise of) the computed `decoration data`
-     */
-    getDecorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data[]>>;
-    /**
-     * Transforms the `decoration data` into an object, so that it can be safely serialized into JSON.
-     * @param decorations the `decoration data` that should be deflated
-     *
-     * @returns the `decoration data` as serializable JSON object
-     */
-    deflateDecorators(decorations: Map<string, TreeDecoration.Data[]>): object;
-    /**
-     * Counterpart of the [deflateDecorators](#deflateDecorators) method. Restores the argument into a Map
-     * of tree node IDs and the corresponding decorations data array (`decoration data`).
-     *
-     * @returns the deserialized `decoration data
-     */
-    inflateDecorators(state: any): Map<string, TreeDecoration.Data[]>;
-}
-/**
- * The default tree decorator service. Does nothing at all. One has to rebind to a concrete implementation
- * if decorators have to be supported in the tree widget.
- */
-export declare class NoopTreeDecoratorService implements TreeDecoratorService {
-    protected readonly emitter: Emitter<void>;
-    readonly onDidChangeDecorations: Event<void>;
-    dispose(): void;
-    getDecorations(): Map<any, any>;
-    deflateDecorators(): object;
-    inflateDecorators(): Map<string, TreeDecoration.Data[]>;
-}
-/**
- * Abstract decorator service implementation which emits events from all known tree decorators and caches the current state.
- */
-export declare abstract class AbstractTreeDecoratorService implements TreeDecoratorService {
-    protected readonly decorators: ReadonlyArray<TreeDecorator>;
-    protected readonly onDidChangeDecorationsEmitter: Emitter<void>;
-    readonly onDidChangeDecorations: Event<void>;
-    protected readonly toDispose: DisposableCollection;
-    constructor(decorators: ReadonlyArray<TreeDecorator>);
-    dispose(): void;
-    getDecorations(tree: Tree): Promise<Map<string, TreeDecoration.Data[]>>;
-    deflateDecorators(decorations: Map<string, TreeDecoration.Data[]>): object;
-    inflateDecorators(state: any): Map<string, TreeDecoration.Data[]>;
-}
-/**
- * @deprecated import from `@theia/core/lib/browser/widget-decoration` instead.
- */
-export import TreeDecoration = WidgetDecoration;
-export interface DecoratedTreeNode extends TreeNode {
-    /**
-     * The additional tree decoration data attached to the tree node itself.
-     */
-    readonly decorationData: TreeDecoration.Data;
-}
-export declare namespace DecoratedTreeNode {
-    /**
-     * Type-guard for decorated tree nodes.
-     */
-    function is(node: TreeNode | undefined): node is DecoratedTreeNode;
-}
+import { Tree, TreeNode } from './tree';
+import { Event, Emitter, Disposable, DisposableCollection, MaybePromise } from '../../common';
+import { WidgetDecoration } from '../widget-decoration';
+/**
+ * The {@link TreeDecorator} allows adapting the look and the style of the tree items within a widget. Changes are reflected in
+ * the form of `decoration data`. This `decoration data` is a map storing {@link TreeDecoration.Data} for affected tree nodes (using the unique node id as key).
+ * It is important to notice that there is no common contribution point for `TreeDecorators`. Instead, each {@link TreeDecoratorService} is
+ * supposed to declare its own contribution provider for `TreeDecorators`.
+ *
+ * ### Example usage
+ * A simple tree decorator that changes the background color of each tree node to `red`.
+ *
+ * ```typescript
+ * @injectable()
+ * export class MyTreeDecorator implements TreeDecorator {
+ *     id = 'myTreeDecorator';
+ *
+ *     protected readonly emitter = new Emitter<(tree: Tree) => Map<string, TreeDecoration.Data>>();
+ *
+ *     get onDidChangeDecorations(): Event<(tree: Tree) => Map<string, TreeDecoration.Data>> {
+ *         return this.emitter.event;
+ *     }
+ *
+ *     decorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data>> {
+ *         const result = new Map();
+ *
+ *         if (tree.root === undefined) {
+ *             return result;
+ *         }
+ *         for (const treeNode of new DepthFirstTreeIterator(tree.root)) {
+ *             result.set(treeNode.id,<TreeDecoration.Data>{backgroundColor:'red'})
+ *         }
+ *         return result;
+ *     }
+ * }
+ * ```
+ */
+export interface TreeDecorator {
+    /**
+     * The unique identifier of the decorator. Ought to be unique in the application.
+     */
+    readonly id: string;
+    /**
+     * Fired when this decorator has calculated all the `decoration data` for the tree nodes.
+     */
+    readonly onDidChangeDecorations: Event<(tree: Tree) => Map<string, TreeDecoration.Data>>;
+    /**
+     * Computes the current `decoration data` for the given tree. Might return a promise if the computation is handled asynchronously.
+     *
+     * @param tree the tree to decorate.
+     *
+     * @returns (a promise of) a map containing the current {@linkTreeDecoration.Data} for each node. Keys are the unique identifier of the tree nodes.
+     */
+    decorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data>>;
+}
+export declare const TreeDecoratorService: unique symbol;
+/**
+ * The {@link TreeDecoratorService} manages a set of known {link TreeDecorator}s and emits events when
+ * any of the known decorators has changes. Typically, a `TreeDecoratorService` provides a contribution point that can be used to
+ * register {@link TreeDecorator}s exclusively for this service.
+ *
+ * ### Example usage
+ * ```typescript
+ * export const MyTreeDecorator = Symbol('MyTreeDecorator');
+ *
+ * @injectable()
+ * export class MyDecorationService extends AbstractTreeDecoratorService {
+ *     constructor(@inject(ContributionProvider) @named(MyTreeDecorator) protected readonly contributions: ContributionProvider<TreeDecorator>) {
+ *         super(contributions.getContributions());
+ *     }
+ * }
+ * ```
+ */
+export interface TreeDecoratorService extends Disposable {
+    /**
+     * Fired when any of the available tree decorators has changes.
+     */
+    readonly onDidChangeDecorations: Event<void>;
+    /**
+     * Computes the decorations for the tree based on the actual state of this decorator service.
+     *
+     * @param tree the tree to decorate
+     *
+     * @returns (a promise of) the computed `decoration data`
+     */
+    getDecorations(tree: Tree): MaybePromise<Map<string, TreeDecoration.Data[]>>;
+    /**
+     * Transforms the `decoration data` into an object, so that it can be safely serialized into JSON.
+     * @param decorations the `decoration data` that should be deflated
+     *
+     * @returns the `decoration data` as serializable JSON object
+     */
+    deflateDecorators(decorations: Map<string, TreeDecoration.Data[]>): object;
+    /**
+     * Counterpart of the [deflateDecorators](#deflateDecorators) method. Restores the argument into a Map
+     * of tree node IDs and the corresponding decorations data array (`decoration data`).
+     *
+     * @returns the deserialized `decoration data
+     */
+    inflateDecorators(state: any): Map<string, TreeDecoration.Data[]>;
+}
+/**
+ * The default tree decorator service. Does nothing at all. One has to rebind to a concrete implementation
+ * if decorators have to be supported in the tree widget.
+ */
+export declare class NoopTreeDecoratorService implements TreeDecoratorService {
+    protected readonly emitter: Emitter<void>;
+    readonly onDidChangeDecorations: Event<void>;
+    dispose(): void;
+    getDecorations(): Map<any, any>;
+    deflateDecorators(): object;
+    inflateDecorators(): Map<string, TreeDecoration.Data[]>;
+}
+/**
+ * Abstract decorator service implementation which emits events from all known tree decorators and caches the current state.
+ */
+export declare abstract class AbstractTreeDecoratorService implements TreeDecoratorService {
+    protected readonly decorators: ReadonlyArray<TreeDecorator>;
+    protected readonly onDidChangeDecorationsEmitter: Emitter<void>;
+    readonly onDidChangeDecorations: Event<void>;
+    protected readonly toDispose: DisposableCollection;
+    constructor(decorators: ReadonlyArray<TreeDecorator>);
+    dispose(): void;
+    getDecorations(tree: Tree): Promise<Map<string, TreeDecoration.Data[]>>;
+    deflateDecorators(decorations: Map<string, TreeDecoration.Data[]>): object;
+    inflateDecorators(state: any): Map<string, TreeDecoration.Data[]>;
+}
+/**
+ * @deprecated import from `@theia/core/lib/browser/widget-decoration` instead.
+ */
+export import TreeDecoration = WidgetDecoration;
+export interface DecoratedTreeNode extends TreeNode {
+    /**
+     * The additional tree decoration data attached to the tree node itself.
+     */
+    readonly decorationData: TreeDecoration.Data;
+}
+export declare namespace DecoratedTreeNode {
+    /**
+     * Type-guard for decorated tree nodes.
+     */
+    function is(node: TreeNode | undefined): node is DecoratedTreeNode;
+}
 //# sourceMappingURL=tree-decorator.d.ts.map