@umbraco-cms/backoffice 1.0.0-next.b82f3242 → 1.0.0-next.bc46b74e

package/models.d.ts

@@ -1,80 +1,13 @@
-import { EntityTreeItemResponseModel, FolderTreeItemResponseModel, PackageManifestResponseModel } from '@umbraco-cms/backoffice/backend-api';
-
 type HTMLElementConstructor<T = HTMLElement> = new (...args: any[]) => T;
 type ClassConstructor<T> = new (...args: any[]) => T;
-interface Entity {
-    id: string;
-    name: string;
-    icon: string;
-    type: string;
-    hasChildren: boolean;
-    parentId: string | null;
-}
 /** Tried to find a common base of our entities — used by Entity Workspace Context */
-type BaseEntity = {
+type UmbEntityBase = {
     id?: string;
     name?: string;
 };
-interface UserEntity extends Entity {
-    type: 'user';
-}
-type UserStatus = 'enabled' | 'inactive' | 'invited' | 'disabled';
-interface UserDetails extends UserEntity {
-    email: string;
-    status: UserStatus;
-    language: string;
-    lastLoginDate?: string;
-    lastLockoutDate?: string;
-    lastPasswordChangeDate?: string;
-    updateDate: string;
-    createDate: string;
-    failedLoginAttempts: number;
-    userGroups: Array<string>;
-    contentStartNodes: Array<string>;
-    mediaStartNodes: Array<string>;
-}
-interface UserGroupEntity extends Entity {
-    type: 'user-group';
-}
-interface UserGroupDetails extends UserGroupEntity {
-    sections: Array<string>;
-    contentStartNode?: string;
-    mediaStartNode?: string;
-    permissions: Array<string>;
-}
-interface MemberTypeDetails extends EntityTreeItemResponseModel {
-    id: string;
-    alias: string;
-    properties: [];
-}
-interface MediaTypeDetails extends FolderTreeItemResponseModel {
-    id: string;
-    alias: string;
-    properties: [];
-}
-interface MemberGroupDetails extends EntityTreeItemResponseModel {
-    id: string;
-}
-interface MemberDetails extends EntityTreeItemResponseModel {
-    id: string;
-}
-interface DocumentBlueprintDetails {
-    id: string;
-    name: string;
-    type: 'document-blueprint';
-    properties: Array<any>;
-    data: Array<any>;
-    icon: string;
-    documentTypeKey: string;
-}
-interface SwatchDetails {
+interface UmbSwatchDetails {
     label: string;
     value: string;
 }
-type UmbPackage = PackageManifestResponseModel;
-type PackageManifestResponse = UmbPackage[];
-type UmbPackageWithMigrationStatus = UmbPackage & {
-    hasPendingMigrations: boolean;
-};
 
-export { BaseEntity, ClassConstructor, DocumentBlueprintDetails, Entity, HTMLElementConstructor, MediaTypeDetails, MemberDetails, MemberGroupDetails, MemberTypeDetails, PackageManifestResponse, SwatchDetails, UmbPackage, UmbPackageWithMigrationStatus, UserDetails, UserEntity, UserGroupDetails, UserGroupEntity, UserStatus };
+export { ClassConstructor, HTMLElementConstructor, UmbEntityBase, UmbSwatchDetails };

package/observable-api.d.ts

@@ -261,6 +261,18 @@ declare function createObservablePart<R, T>(source$: Observable<T>, mappingFunct
  */
 declare function appendToFrozenArray<T>(data: T[], entry: T, getUniqueMethod?: (entry: T) => unknown): T[];
 
+/**
+ * @export
+ * @method filterFrozenArray
+ * @param {Array<T>} data - RxJS Subject to use for this Observable.
+ * @param {(entry: T) => boolean} filterMethod - Method to filter the array.
+ * @description - Creates a RxJS Observable from RxJS Subject.
+ * @example <caption>Example remove an entry of a ArrayState or a part of DeepState/ObjectState it which is an array. Where the key is unique and the item will be updated if matched with existing.</caption>
+ * const newDataSet = filterFrozenArray(mySubject.getValue(), x => x.id !== "myKey");
+ * mySubject.next(newDataSet);
+ */
+declare function filterFrozenArray<T>(data: T[], filterMethod: (entry: T) => boolean): T[];
+
 /**
  * @export
  * @method partialUpdateFrozenArray
@@ -275,4 +287,4 @@ declare function appendToFrozenArray<T>(data: T[], entry: T, getUniqueMethod?: (
  */
 declare function partialUpdateFrozenArray<T>(data: T[], partialEntry: Partial<T>, findMethod: (entry: T) => boolean): T[];
 
-export { MappingFunction, UmbArrayState, UmbBasicState, UmbBooleanState, UmbClassState, UmbDeepState, UmbNumberState, UmbObjectState, UmbObserver, UmbObserverController, UmbStringState, appendToFrozenArray, createObservablePart, partialUpdateFrozenArray };
+export { MappingFunction, UmbArrayState, UmbBasicState, UmbBooleanState, UmbClassState, UmbDeepState, UmbNumberState, UmbObjectState, UmbObserver, UmbObserverController, UmbStringState, appendToFrozenArray, createObservablePart, filterFrozenArray, partialUpdateFrozenArray };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@umbraco-cms/backoffice",
-	"version": "1.0.0-next.b82f3242",
+	"version": "1.0.0-next.bc46b74e",
 	"license": "MIT",
 	"keywords": [
 		"umbraco",

package/picker-input.d.ts

@@ -1,7 +1,7 @@
 import * as rxjs from 'rxjs';
 import { UmbItemRepository } from '@umbraco-cms/backoffice/repository';
 import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller';
-import { UmbModalToken, UmbModalContext } from '@umbraco-cms/backoffice/modal';
+import { UmbModalToken, UmbModalContext, UmbPickerModalData } from '@umbraco-cms/backoffice/modal';
 import { ItemResponseModelBaseModel } from '@umbraco-cms/backoffice/backend-api';
 
 declare class UmbPickerInputContext<ItemType extends ItemResponseModelBaseModel> {
@@ -10,6 +10,7 @@ declare class UmbPickerInputContext<ItemType extends ItemResponseModelBaseModel>
     modalAlias: string | UmbModalToken;
     repository?: UmbItemRepository<ItemType>;
     modalContext?: UmbModalContext;
+    pickableFilter?: (item: ItemType) => boolean;
     selection: rxjs.Observable<string[]>;
     selectedItems: rxjs.Observable<ItemType[]>;
     max: number;
@@ -17,7 +18,7 @@ declare class UmbPickerInputContext<ItemType extends ItemResponseModelBaseModel>
     constructor(host: UmbControllerHostElement, repositoryAlias: string, modalAlias: string | UmbModalToken, getUniqueMethod?: (entry: ItemType) => string | undefined);
     getSelection(): string[];
     setSelection(selection: string[]): void;
-    openPicker(pickerData?: any): void;
+    openPicker(pickerData?: Partial<UmbPickerModalData<ItemType>>): void;
     requestRemoveItem(unique: string): Promise<void>;
 }
 

package/repository.d.ts

@@ -1,18 +1,19 @@
-import { ProblemDetailsModel, FolderReponseModel, CreateFolderRequestModel, UpdateFolderReponseModel, FolderModelBaseModel, ItemResponseModelBaseModel } from '@umbraco-cms/backoffice/backend-api';
+import { ApiError, CancelError, FolderReponseModel, CreateFolderRequestModel, UpdateFolderReponseModel, TreeItemPresentationModel, ProblemDetailsModel, FolderModelBaseModel, ItemResponseModelBaseModel } from '@umbraco-cms/backoffice/backend-api';
 import { DataSourceResponse as DataSourceResponse$1, UmbDataSourceErrorResponse as UmbDataSourceErrorResponse$1 } from '@umbraco-cms/backoffice/repository';
 import { Observable } from 'rxjs';
+import { UmbTreeRootModel, UmbTreeRootEntityModel } from '@umbraco-cms/backoffice/tree';
 
 interface DataSourceResponse<T = undefined> extends UmbDataSourceErrorResponse {
     data?: T;
 }
 interface UmbDataSourceErrorResponse {
-    error?: ProblemDetailsModel;
+    error?: ApiError | CancelError;
 }
 
-interface UmbDataSource<CreateRequestType, UpdateRequestType, ResponseType> {
+interface UmbDataSource<CreateRequestType, CreateResponseType, UpdateRequestType, ResponseType> {
     createScaffold(parentId: string | null): Promise<DataSourceResponse$1<CreateRequestType>>;
     get(unique: string): Promise<DataSourceResponse$1<ResponseType>>;
-    insert(data: CreateRequestType): Promise<any>;
+    insert(data: CreateRequestType): Promise<DataSourceResponse$1<CreateResponseType>>;
     update(unique: string, data: UpdateRequestType): Promise<DataSourceResponse$1<ResponseType>>;
     delete(unique: string): Promise<DataSourceResponse$1>;
 }
@@ -25,10 +26,39 @@ interface UmbFolderDataSource {
     delete(unique: string): Promise<DataSourceResponse>;
 }
 
-interface UmbTreeDataSource<PagedItemsType = any, ItemsType = any> {
-    getRootItems(): Promise<DataSourceResponse$1<PagedItemsType>>;
-    getChildrenOf(parentUnique: string): Promise<DataSourceResponse$1<PagedItemsType>>;
-    getItems(unique: Array<string>): Promise<DataSourceResponse$1<Array<ItemsType>>>;
+interface UmbPagedData<T> {
+    total: number;
+    items: Array<T>;
+}
+interface UmbTreeRepository<TreeItemType extends TreeItemPresentationModel, TreeRootType extends UmbTreeRootModel = UmbTreeRootEntityModel> {
+    requestTreeRoot: () => Promise<{
+        data?: TreeRootType;
+        error?: ProblemDetailsModel;
+    }>;
+    requestRootTreeItems: () => Promise<{
+        data?: UmbPagedData<TreeItemType>;
+        error?: ProblemDetailsModel;
+        asObservable?: () => Observable<TreeItemType[]>;
+    }>;
+    requestTreeItemsOf: (parentUnique: string | null) => Promise<{
+        data?: UmbPagedData<TreeItemType>;
+        error?: ProblemDetailsModel;
+        asObservable?: () => Observable<TreeItemType[]>;
+    }>;
+    requestItemsLegacy?: (uniques: string[]) => Promise<{
+        data?: Array<TreeItemType>;
+        error?: ProblemDetailsModel;
+        asObservable?: () => Observable<any[]>;
+    }>;
+    rootTreeItems: () => Promise<Observable<TreeItemType[]>>;
+    treeItemsOf: (parentUnique: string | null) => Promise<Observable<TreeItemType[]>>;
+    itemsLegacy?: (uniques: string[]) => Promise<Observable<any[]>>;
+}
+
+interface UmbTreeDataSource<ItemType = any, PagedItemType = UmbPagedData<ItemType>> {
+    getRootItems(): Promise<DataSourceResponse<PagedItemType>>;
+    getChildrenOf(parentUnique: string | null): Promise<DataSourceResponse<PagedItemType>>;
+    getItems(unique: Array<string>): Promise<DataSourceResponse<Array<any>>>;
 }
 
 interface UmbItemDataSource<ItemType> {
@@ -36,11 +66,16 @@ interface UmbItemDataSource<ItemType> {
 }
 
 interface UmbMoveDataSource {
-    move(unique: string, targetUnique: string): Promise<UmbDataSourceErrorResponse$1>;
+    move(unique: string, targetUnique: string | null): Promise<UmbDataSourceErrorResponse$1>;
 }
 
 interface UmbCopyDataSource {
-    copy(unique: string, targetUnique: string): Promise<DataSourceResponse$1<string>>;
+    copy(unique: string, targetUnique: string | null): Promise<DataSourceResponse$1<string>>;
+}
+
+interface UmbCollectionDataSource<ItemType = any, PagedItemType = UmbPagedData<ItemType>> {
+    getCollection(): Promise<DataSourceResponse<PagedItemType>>;
+    filterCollection(filter: any): Promise<DataSourceResponse<PagedItemType>>;
 }
 
 interface UmbRepositoryErrorResponse {
@@ -49,39 +84,15 @@ interface UmbRepositoryErrorResponse {
 interface UmbRepositoryResponse<T> extends UmbRepositoryErrorResponse {
     data?: T;
 }
-interface UmbDetailRepository<CreateRequestType = any, UpdateRequestType = any, ResponseType = any> {
+interface UmbDetailRepository<CreateRequestType = any, CreateResponseType = any, UpdateRequestType = any, ResponseType = any> {
     createScaffold(parentId: string | null): Promise<UmbRepositoryResponse<CreateRequestType>>;
     requestById(id: string): Promise<UmbRepositoryResponse<ResponseType>>;
-    create(data: CreateRequestType): Promise<UmbRepositoryErrorResponse>;
+    byId(id: string): Promise<Observable<ResponseType>>;
+    create(data: CreateRequestType): Promise<UmbRepositoryResponse<CreateResponseType>>;
     save(id: string, data: UpdateRequestType): Promise<UmbRepositoryErrorResponse>;
     delete(id: string): Promise<UmbRepositoryErrorResponse>;
 }
 
-interface UmbPagedData<T> {
-    total: number;
-    items: Array<T>;
-}
-interface UmbTreeRepository<ItemType = any, PagedItemType = UmbPagedData<ItemType>> {
-    requestRootTreeItems: () => Promise<{
-        data: PagedItemType | undefined;
-        error: ProblemDetailsModel | undefined;
-        asObservable?: () => Observable<ItemType[]>;
-    }>;
-    requestTreeItemsOf: (parentUnique: string | null) => Promise<{
-        data: PagedItemType | undefined;
-        error: ProblemDetailsModel | undefined;
-        asObservable?: () => Observable<ItemType[]>;
-    }>;
-    requestItemsLegacy?: (uniques: string[]) => Promise<{
-        data: Array<ItemType> | undefined;
-        error: ProblemDetailsModel | undefined;
-        asObservable?: () => Observable<ItemType[]>;
-    }>;
-    rootTreeItems: () => Promise<Observable<ItemType[]>>;
-    treeItemsOf: (parentUnique: string | null) => Promise<Observable<ItemType[]>>;
-    itemsLegacy?: (uniques: string[]) => Promise<Observable<ItemType[]>>;
-}
-
 interface UmbFolderRepository {
     createFolderScaffold(parentId: string | null): Promise<{
         data?: FolderReponseModel;
@@ -104,6 +115,10 @@ interface UmbFolderRepository {
     }>;
 }
 
+interface UmbCollectionRepository {
+    requestCollection(filter?: any): Promise<any>;
+}
+
 interface UmbItemRepository<ItemType extends ItemResponseModelBaseModel> {
     requestItems: (uniques: string[]) => Promise<{
         data?: Array<ItemType> | undefined;
@@ -121,4 +136,4 @@ interface UmbCopyRepository {
     copy(unique: string, targetUnique: string): Promise<UmbRepositoryResponse<string>>;
 }
 
-export { DataSourceResponse, UmbCopyDataSource, UmbCopyRepository, UmbDataSource, UmbDataSourceErrorResponse, UmbDetailRepository, UmbFolderDataSource, UmbFolderRepository, UmbItemDataSource, UmbItemRepository, UmbMoveDataSource, UmbMoveRepository, UmbPagedData, UmbRepositoryErrorResponse, UmbRepositoryResponse, UmbTreeDataSource, UmbTreeRepository };
+export { DataSourceResponse, UmbCollectionDataSource, UmbCollectionRepository, UmbCopyDataSource, UmbCopyRepository, UmbDataSource, UmbDataSourceErrorResponse, UmbDetailRepository, UmbFolderDataSource, UmbFolderRepository, UmbItemDataSource, UmbItemRepository, UmbMoveDataSource, UmbMoveRepository, UmbPagedData, UmbRepositoryErrorResponse, UmbRepositoryResponse, UmbTreeDataSource, UmbTreeRepository };

package/resources.d.ts

@@ -1,25 +1,20 @@
 import { UmbNotificationOptions } from '@umbraco-cms/backoffice/notification';
-import { ProblemDetailsModel } from '@umbraco-cms/backoffice/backend-api';
 import { UmbController, UmbControllerHostElement } from '@umbraco-cms/backoffice/controller';
 import { DataSourceResponse as DataSourceResponse$1 } from '@umbraco-cms/backoffice/repository';
+import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
+import { ApiError, CancelError } from '@umbraco-cms/backoffice/backend-api';
 
 declare class UmbResourceController extends UmbController {
     #private;
     constructor(host: UmbControllerHostElement, promise: Promise<any>, alias?: string);
     hostConnected(): void;
     hostDisconnected(): void;
-    /**
-     * Extract the ProblemDetailsModel object from an ApiError.
-     *
-     * This assumes that all ApiErrors contain a ProblemDetailsModel object in their body.
-     */
-    static toProblemDetailsModel(error: unknown): ProblemDetailsModel | undefined;
     /**
      * Base execute function with a try/catch block and return a tuple with the result and the error.
      */
     static tryExecute<T>(promise: Promise<T>): Promise<DataSourceResponse$1<T>>;
     /**
-     * Wrap the {execute} function in a try/catch block and return the result.
+     * Wrap the {tryExecute} function in a try/catch block and return the result.
      * If the executor function throws an error, then show the details in a notification.
      */
     tryExecuteAndNotify<T>(options?: UmbNotificationOptions): Promise<DataSourceResponse$1<T>>;
@@ -38,15 +33,27 @@ declare class UmbResourceController extends UmbController {
     destroy(): void;
 }
 
+/**
+ * The base URL of the configured Umbraco server.
+ * If the server is local, this will be an empty string.
+ *
+ * @remarks This is the base URL of the Umbraco server, not the base URL of the backoffice.
+ *
+ * @example https://localhost:44300
+ * @example https://my-umbraco-site.com
+ * @example ''
+ */
+declare const UMB_SERVER_URL: UmbContextToken<string>;
+
 interface DataSourceResponse<T = undefined> extends UmbDataSourceErrorResponse {
     data?: T;
 }
 interface UmbDataSourceErrorResponse {
-    error?: ProblemDetailsModel;
+    error?: ApiError | CancelError;
 }
 
 declare function tryExecute<T>(promise: Promise<T>): Promise<DataSourceResponse<T>>;
 
-declare function tryExecuteAndNotify<T>(host: UmbControllerHostElement, resource: Promise<T>, options?: UmbNotificationOptions<any>): Promise<DataSourceResponse<T>>;
+declare function tryExecuteAndNotify<T>(host: UmbControllerHostElement, resource: Promise<T>, options?: UmbNotificationOptions): Promise<DataSourceResponse<T>>;
 
-export { UmbResourceController, tryExecute, tryExecuteAndNotify };
+export { UMB_SERVER_URL, UmbResourceController, tryExecute, tryExecuteAndNotify };

package/router.d.ts

@@ -22,7 +22,6 @@ type IRoutingInfo<D = any, P = any> = {
 };
 type CustomResolver<D = any, P = any> = ((info: IRoutingInfo<D>) => boolean | void | Promise<boolean> | Promise<void>);
 type Guard<D = any, P = any> = ((info: IRoutingInfo<D, P>) => boolean | Promise<boolean>);
-type Cancel = (() => boolean);
 type PageComponent = HTMLElement | undefined;
 type ModuleResolver = Promise<{
     default: any;
@@ -99,10 +98,6 @@ type Query = {
     [key: string]: string;
 };
 type EventListenerSubscription = (() => void);
-/**
- * RouterSlot related events.
- */
-type RouterSlotEvent = "changestate";
 /**
  * History related events.
  */
@@ -355,13 +350,6 @@ declare function toQueryString(query: Query): string;
  */
 declare function ensureAnchorHistory(): void;
 
-interface UmbRouteLocation {
-    name?: string;
-    params: {
-        [key: string]: string;
-    };
-}
-
 declare class UmbRouteContext {
     #private;
     private _onGotModals;
@@ -377,4 +365,4 @@ declare function generateRoutePathBuilder(path: string): (params: {
     [key: string]: string | number;
 }) => string;
 
-export { Cancel, ChangeStateEvent, Class, Component, CustomResolver, EventListenerSubscription, GlobalRouterEvent, Guard, IComponentRoute, IPathFragments, IRedirectRoute, IResolverRoute, IRoute, IRouteBase, IRouteMatch, IRouterSlot, IRoutingInfo, ISlashOptions, ModuleResolver, NavigationCancelEvent, NavigationEndEvent, NavigationErrorEvent, NavigationStartEvent, NavigationSuccessEvent, PageComponent, Params, PathFragment, PathMatch, PushStateEvent, Query, ReplaceStateEvent, RouterSlotEvent, RouterTree, Setup, UMB_ROUTE_CONTEXT_TOKEN, IRoute as UmbRoute, UmbRouteContext, UmbRouteLocation, WillChangeStateEvent, addListener, attachCallback, basePath, constructAbsolutePath, constructPathWithBasePath, dispatchGlobalRouterEvent, dispatchRouteChangeEvent, ensureAnchorHistory, ensureHistoryEvents, ensureSlash, generateRoutePathBuilder, getFragments, handleRedirect, historyPatches, isPathActive, isRedirectRoute, isResolverRoute, matchRoute, matchRoutes, path, pathWithoutBasePath, query, queryParentRoots, queryParentRouterSlot, queryString, removeListeners, resolvePageComponent, saveNativeFunction, shouldNavigate, slashify, stripSlash, stripStart, toQuery, toQueryString, traverseRouterTree };
+export { Guard, IComponentRoute, IRedirectRoute, IResolverRoute, IRoutingInfo, PageComponent, Params, Query, UMB_ROUTE_CONTEXT_TOKEN, IRoute as UmbRoute, UmbRouteContext, addListener, attachCallback, basePath, constructAbsolutePath, constructPathWithBasePath, dispatchGlobalRouterEvent, dispatchRouteChangeEvent, ensureAnchorHistory, ensureHistoryEvents, ensureSlash, generateRoutePathBuilder, getFragments, handleRedirect, historyPatches, isPathActive, isRedirectRoute, isResolverRoute, matchRoute, matchRoutes, path, pathWithoutBasePath, query, queryParentRoots, queryParentRouterSlot, queryString, removeListeners, resolvePageComponent, saveNativeFunction, shouldNavigate, slashify, stripSlash, stripStart, toQuery, toQueryString, traverseRouterTree };

package/section.d.ts

@@ -0,0 +1,29 @@
+import * as rxjs from 'rxjs';
+import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
+import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller';
+import { ManifestSection } from '@umbraco-cms/backoffice/extensions-registry';
+
+declare class UmbSectionSidebarContext {
+    #private;
+    contextMenuIsOpen: rxjs.Observable<boolean>;
+    entityType: rxjs.Observable<string | undefined>;
+    unique: rxjs.Observable<string | null | undefined>;
+    headline: rxjs.Observable<string | undefined>;
+    constructor(host: UmbControllerHostElement);
+    toggleContextMenu(entityType: string, unique: string | null | undefined, headline: string): void;
+    openContextMenu(entityType: string, unique: string | null | undefined, headline: string): void;
+    closeContextMenu(): void;
+}
+declare const UMB_SECTION_SIDEBAR_CONTEXT_TOKEN: UmbContextToken<UmbSectionSidebarContext>;
+
+declare class UmbSectionContext {
+    #private;
+    readonly alias: rxjs.Observable<string | undefined>;
+    readonly pathname: rxjs.Observable<string | undefined>;
+    readonly label: rxjs.Observable<string | undefined>;
+    constructor(manifest: ManifestSection);
+    setManifest(manifest?: ManifestSection): void;
+}
+declare const UMB_SECTION_CONTEXT_TOKEN: UmbContextToken<UmbSectionContext>;
+
+export { UMB_SECTION_CONTEXT_TOKEN, UMB_SECTION_SIDEBAR_CONTEXT_TOKEN, UmbSectionContext, UmbSectionSidebarContext };

package/sorter.d.ts

@@ -0,0 +1,103 @@
+import { UmbControllerInterface, UmbControllerHostElement } from '@umbraco-cms/backoffice/controller';
+
+type INTERNAL_UmbSorterConfig<T> = {
+    compareElementToModel: (el: HTMLElement, modelEntry: T) => boolean;
+    querySelectModelToElement: (container: HTMLElement, modelEntry: T) => HTMLElement | null;
+    identifier: string;
+    itemSelector: string;
+    disabledItemSelector?: string;
+    containerSelector: string;
+    ignorerSelector: string;
+    placeholderClass: string;
+    draggableSelector?: string;
+    boundarySelector?: string;
+    dataTransferResolver?: (dataTransfer: DataTransfer | null, currentItem: T) => void;
+    onStart?: (argument: {
+        item: T;
+        element: HTMLElement;
+    }) => void;
+    onChange?: (argument: {
+        item: T;
+        element: HTMLElement;
+    }) => void;
+    onContainerChange?: (argument: {
+        item: T;
+        element: HTMLElement;
+    }) => void;
+    onEnd?: (argument: {
+        item: T;
+        element: HTMLElement;
+    }) => void;
+    onSync?: (argument: {
+        item: T;
+        fromController: UmbSorterController<T>;
+        toController: UmbSorterController<T>;
+    }) => void;
+    itemHasNestedContainersResolver?: (element: HTMLElement) => boolean;
+    onDisallowed?: () => void;
+    onAllowed?: () => void;
+    onRequestDrop?: (argument: {
+        item: T;
+    }) => boolean | void;
+    resolveVerticalDirection?: (argument: {
+        containerElement: Element;
+        containerRect: DOMRect;
+        item: T;
+        element: HTMLElement;
+        elementRect: DOMRect;
+        relatedElement: HTMLElement;
+        relatedRect: DOMRect;
+        placeholderIsInThisRow: boolean;
+        horizontalPlaceAfter: boolean;
+    }) => void;
+    performItemInsert?: (argument: {
+        item: T;
+        newIndex: number;
+    }) => Promise<boolean> | boolean;
+    performItemRemove?: (argument: {
+        item: T;
+    }) => Promise<boolean> | boolean;
+};
+type UmbSorterConfig<T> = Omit<INTERNAL_UmbSorterConfig<T>, 'placeholderClass' | 'ignorerSelector' | 'containerSelector'> & Partial<Pick<INTERNAL_UmbSorterConfig<T>, 'placeholderClass' | 'ignorerSelector' | 'containerSelector'>>;
+/**
+ * @export
+ * @class UmbSorterController
+ * @implements {UmbControllerInterface}
+ * @description This controller can make user able to sort items.
+ */
+declare class UmbSorterController<T> implements UmbControllerInterface {
+    #private;
+    private _lastIndicationContainerVM;
+    get unique(): string;
+    constructor(host: UmbControllerHostElement, config: UmbSorterConfig<T>);
+    setModel(model: Array<T>): void;
+    hostConnected(): void;
+    private _onFirstRender;
+    hostDisconnected(): void;
+    setupItem(element: HTMLElement): void;
+    destroyItem(element: HTMLElement): void;
+    handleDragStart: (event: DragEvent) => void;
+    handleDragEnd: () => Promise<void>;
+    handleDragMove: (event: DragEvent) => void;
+    moveCurrentElement: () => void;
+    move(orderedContainerElements: Array<Element>, newElIndex: number): void;
+    /** Management methods: */
+    getItemOfElement(element: HTMLElement): T | null | undefined;
+    removeItem(item: T): Promise<boolean | T | null>;
+    hasOtherItemsThan(item: T): boolean;
+    sync(element: HTMLElement, fromVm: UmbSorterController<T>): Promise<boolean>;
+    updateAllowIndication(contextVM: UmbSorterController<T>, item: T): boolean;
+    removeAllowIndication(): void;
+    private autoScrollX;
+    private autoScrollY;
+    private handleAutoScroll;
+    private _performAutoScroll;
+    private stopAutoScroll;
+    notifySync(data: any): void;
+    notifyDisallowed(): void;
+    notifyAllowed(): void;
+    notifyRequestDrop(data: any): boolean;
+    destroy(): void;
+}
+
+export { UmbSorterConfig, UmbSorterController };

package/store.d.ts

@@ -97,7 +97,7 @@ declare class UmbEntityTreeStore extends UmbStoreBase$1<EntityTreeItemResponseMo
      * @return {*}
      * @memberof UmbEntityTreeStore
      */
-    items(ids: Array<string>): rxjs.Observable<EntityTreeItemResponseModel[]>;
+    items(ids: Array<string | null>): rxjs.Observable<EntityTreeItemResponseModel[]>;
 }
 
 /**

package/tree.d.ts

@@ -0,0 +1,136 @@
+import * as _umbraco_cms_backoffice_backend_api from '@umbraco-cms/backoffice/backend-api';
+import { TreeItemPresentationModel, ProblemDetailsModel } from '@umbraco-cms/backoffice/backend-api';
+import * as rxjs from 'rxjs';
+import { Observable } from 'rxjs';
+import { UmbControllerHostElement } from '@umbraco-cms/backoffice/controller';
+import { UmbPagedData as UmbPagedData$1, UmbTreeRepository } from '@umbraco-cms/backoffice/repository';
+import { UmbTreeContextBase as UmbTreeContextBase$1 } from '@umbraco-cms/backoffice/tree';
+import { UmbContextToken } from '@umbraco-cms/backoffice/context-api';
+
+interface UmbTreeContext<TreeItemType extends TreeItemPresentationModel> {
+    readonly selectable: Observable<boolean>;
+    readonly selection: Observable<Array<string | null>>;
+    setSelectable(value: boolean): void;
+    getSelectable(): boolean;
+    setMultiple(value: boolean): void;
+    getMultiple(): boolean;
+    setSelection(value: Array<string | null>): void;
+    getSelection(): Array<string | null>;
+    select(unique: string | null): void;
+    deselect(unique: string | null): void;
+    requestChildrenOf: (parentUnique: string | null) => Promise<{
+        data?: UmbPagedData$1<TreeItemType>;
+        error?: ProblemDetailsModel;
+        asObservable?: () => Observable<TreeItemType[]>;
+    }>;
+}
+declare class UmbTreeContextBase<TreeItemType extends TreeItemPresentationModel> implements UmbTreeContext<TreeItemType> {
+    #private;
+    host: UmbControllerHostElement;
+    readonly selectable: Observable<boolean>;
+    readonly multiple: Observable<boolean>;
+    readonly selection: Observable<(string | null)[]>;
+    repository?: UmbTreeRepository<TreeItemType>;
+    selectableFilter?: (item: TreeItemType) => boolean;
+    constructor(host: UmbControllerHostElement);
+    setTreeAlias(treeAlias?: string): Promise<void>;
+    getTreeAlias(): string | undefined;
+    setSelectable(value: boolean): void;
+    getSelectable(): boolean;
+    setMultiple(value: boolean): void;
+    getMultiple(): boolean;
+    setSelection(value: Array<string | null>): void;
+    getSelection(): (string | null)[];
+    select(unique: string | null): void;
+    deselect(unique: string | null): void;
+    requestTreeRoot(): Promise<{
+        data?: UmbTreeRootEntityModel | undefined;
+        error?: ProblemDetailsModel | undefined;
+    }>;
+    requestRootItems(): Promise<{
+        data?: UmbPagedData$1<TreeItemType> | undefined;
+        error?: ProblemDetailsModel | undefined;
+        asObservable?: (() => Observable<TreeItemType[]>) | undefined;
+    }>;
+    requestChildrenOf(parentUnique: string | null): Promise<{
+        data?: UmbPagedData$1<TreeItemType> | undefined;
+        error?: ProblemDetailsModel | undefined;
+        asObservable?: (() => Observable<TreeItemType[]>) | undefined;
+    }>;
+    rootItems(): Promise<Observable<TreeItemType[]>>;
+    childrenOf(parentUnique: string | null): Promise<Observable<TreeItemType[]>>;
+}
+
+interface UmbPagedData<T> {
+    total: number;
+    items: Array<T>;
+}
+
+interface UmbTreeItemContext<TreeItemType extends TreeItemPresentationModel> {
+    host: UmbControllerHostElement;
+    unique?: string | null;
+    type?: string;
+    treeItem: Observable<TreeItemType | undefined>;
+    hasChildren: Observable<boolean>;
+    isLoading: Observable<boolean>;
+    isSelectable: Observable<boolean>;
+    isSelected: Observable<boolean>;
+    isActive: Observable<boolean>;
+    hasActions: Observable<boolean>;
+    path: Observable<string>;
+    setTreeItem(treeItem: TreeItemType | undefined): void;
+    requestChildren(): Promise<{
+        data?: UmbPagedData$1<TreeItemType> | undefined;
+        error?: ProblemDetailsModel | undefined;
+        asObservable?: () => Observable<TreeItemType[]>;
+    }>;
+    toggleContextMenu(): void;
+    select(): void;
+    deselect(): void;
+    constructPath(pathname: string, entityType: string, unique: string): string;
+}
+
+type UmbTreeItemUniqueFunction<TreeItemType extends TreeItemPresentationModel> = (x: TreeItemType) => string | null | undefined;
+declare class UmbTreeItemContextBase<TreeItemType extends TreeItemPresentationModel> implements UmbTreeItemContext<TreeItemType> {
+    #private;
+    host: UmbControllerHostElement;
+    unique?: string | null;
+    type?: string;
+    treeItem: rxjs.Observable<TreeItemType | undefined>;
+    hasChildren: rxjs.Observable<boolean>;
+    isLoading: rxjs.Observable<boolean>;
+    isSelectable: rxjs.Observable<boolean>;
+    isSelected: rxjs.Observable<boolean>;
+    isActive: rxjs.Observable<boolean>;
+    hasActions: rxjs.Observable<boolean>;
+    path: rxjs.Observable<string>;
+    treeContext?: UmbTreeContextBase$1<TreeItemType>;
+    constructor(host: UmbControllerHostElement, getUniqueFunction: UmbTreeItemUniqueFunction<TreeItemType>);
+    setTreeItem(treeItem: TreeItemType | undefined): void;
+    requestChildren(): Promise<{
+        data?: UmbPagedData<TreeItemType> | undefined;
+        error?: _umbraco_cms_backoffice_backend_api.ProblemDetailsModel | undefined;
+        asObservable?: (() => rxjs.Observable<TreeItemType[]>) | undefined;
+    }>;
+    toggleContextMenu(): void;
+    select(): void;
+    deselect(): void;
+    getTreeItem(): TreeItemType | undefined;
+    constructPath(pathname: string, entityType: string, unique: string | null): string;
+}
+declare const UMB_TREE_ITEM_CONTEXT_TOKEN: UmbContextToken<UmbTreeItemContext<any>>;
+
+interface UmbTreeRootModel {
+    type: string;
+    name: string;
+    hasChildren: boolean;
+    icon?: string;
+}
+interface UmbTreeRootEntityModel extends UmbTreeRootModel {
+    id: string | null;
+}
+interface UmbTreeRootFileSystemModel extends UmbTreeRootModel {
+    path: string | null;
+}
+
+export { UMB_TREE_ITEM_CONTEXT_TOKEN, UmbTreeContext, UmbTreeContextBase, UmbTreeItemContext, UmbTreeItemContextBase, UmbTreeItemUniqueFunction, UmbTreeRootEntityModel, UmbTreeRootFileSystemModel, UmbTreeRootModel };