@umbraco-cms/backoffice 16.3.0-rc3 → 17.0.0-beta

package/dist-cms/packages/core/tree/tree-item/tree-item-expansion.manager.js

@@ -0,0 +1,83 @@
+import { UMB_TREE_CONTEXT } from '../tree.context.token.js';
+import { UmbBooleanState } from '../../../../libs/observable-api/index.js';
+import { UmbControllerBase } from '../../../../libs/class-api/index.js';
+export class UmbTreeItemTargetExpansionManager extends UmbControllerBase {
+    #isExpanded;
+    #treeItem;
+    #observerController;
+    #init;
+    #childrenManager;
+    #targetPaginationManager;
+    #treeContext;
+    constructor(host, args) {
+        super(host);
+        this.#isExpanded = new UmbBooleanState(false);
+        this.isExpanded = this.#isExpanded.asObservable();
+        this.#childrenManager = args.childrenManager;
+        this.#targetPaginationManager = args.targetPaginationManager;
+        this.#init = Promise.all([
+            this.consumeContext(UMB_TREE_CONTEXT, (treeContext) => {
+                this.#treeContext = treeContext;
+            }).asPromise(),
+        ]);
+    }
+    /**
+     * Set the parent for which to load children.
+     * @param {(TreeItemType | TreeRootType | undefined)} treeItem - The tree item model
+     * @memberof UmbTreeItemChildrenManager
+     */
+    setTreeItem(treeItem) {
+        // If we don't get a tree item stop the observation
+        if (!treeItem) {
+            this.#observerController?.destroy();
+            return;
+        }
+        // If we get the same tree item again, continue with the same observation
+        if (treeItem.entityType === this.#treeItem?.entityType && treeItem.unique === this.#treeItem?.unique) {
+            return;
+        }
+        this.#treeItem = treeItem;
+        this.#observeExpansionForTreeItem(this.#treeItem);
+    }
+    /**
+     * Gets the tree item for which to load children.
+     * @returns {TreeItemType | TreeRootType | undefined} - The tree item for the children
+     * @memberof UmbTreeItemChildrenManager
+     */
+    getTreeItem() {
+        return this.#treeItem;
+    }
+    async #observeExpansionForTreeItem(treeItem) {
+        await this.#init;
+        if (!this.#treeContext) {
+            throw new Error('Tree context is not set');
+        }
+        this.#observerController = this.observe(this.#treeContext?.expansion.entry(treeItem), async (entry) => {
+            const isExpanded = entry !== undefined;
+            this.#isExpanded.setValue(isExpanded);
+            const currentBaseTarget = this.#targetPaginationManager.getBaseTarget();
+            const target = entry?.target;
+            /* If a base target already exists (tree loaded to that point),
+      don’t auto-reset when the target is removed.
+      This happens when creating new items not yet in the tree. */
+            if (currentBaseTarget && !target) {
+                return;
+            }
+            /* If a new target is set we only want to reload children if the new target isn’t among the already loaded items. */
+            const targetIsLoaded = this.#childrenManager.isChildLoaded(target);
+            if (target && targetIsLoaded) {
+                return;
+            }
+            // If we already have children and the target didn't change then we don't have to load new children
+            const isNewTarget = target !== currentBaseTarget;
+            if (isExpanded && this.#childrenManager.hasLoadedChildren() && !isNewTarget) {
+                return;
+            }
+            // If this item is expanded and has children, load them
+            if (isExpanded && this.#childrenManager.getHasChildren()) {
+                this.#targetPaginationManager.setBaseTarget(target);
+                this.#childrenManager.loadChildren();
+            }
+        }, 'observeExpansion');
+    }
+}

package/dist-cms/packages/core/tree/tree-item/tree-item.context.token.d.ts

@@ -0,0 +1,3 @@
+import type { UmbTreeItemContext } from './tree-item-context.interface.js';
+import { UmbContextToken } from '../../../../libs/context-api/index.js';
+export declare const UMB_TREE_ITEM_CONTEXT: UmbContextToken<UmbTreeItemContext<import("../types.js").UmbTreeItemModel>, UmbTreeItemContext<import("../types.js").UmbTreeItemModel>>;

package/dist-cms/packages/core/tree/tree-item/tree-item.context.token.js

@@ -0,0 +1,2 @@
+import { UmbContextToken } from '../../../../libs/context-api/index.js';
+export const UMB_TREE_ITEM_CONTEXT = new UmbContextToken('UmbTreeItemContext');

package/dist-cms/packages/core/tree/tree-item/tree-item.element.d.ts

@@ -1,11 +1,15 @@
 import type { ManifestTreeItem } from '../extensions/types.js';
+import UmbDefaultTreeItemContext from './tree-item-default/tree-item-default.context.js';
 import { UmbExtensionElementAndApiSlotElementBase } from '../../extension-registry/index.js';
 export declare class UmbTreeItemElement extends UmbExtensionElementAndApiSlotElementBase<ManifestTreeItem> {
     #private;
     get entityType(): string | undefined;
     set entityType(newVal: string | undefined);
+    set props(newVal: Record<string, unknown> | undefined);
+    get props(): Record<string, unknown> | undefined;
     getExtensionType(): string;
     getDefaultElementName(): string;
+    getDefaultApiConstructor(): typeof UmbDefaultTreeItemContext;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist-cms/packages/core/tree/tree-item/tree-item.element.js

@@ -4,6 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+import UmbDefaultTreeItemContext from './tree-item-default/tree-item-default.context.js';
 import { customElement, property } from '../../../../external/lit/index.js';
 import { UmbExtensionElementAndApiSlotElementBase, umbExtensionsRegistry, } from '../../extension-registry/index.js';
 import { createObservablePart } from '../../../../libs/observable-api/index.js';
@@ -16,6 +17,13 @@ let UmbTreeItemElement = class UmbTreeItemElement extends UmbExtensionElementAnd
         this.#observeEntityType();
     }
     #entityType;
+    set props(newVal) {
+        super.props = newVal;
+        this.#assignProps();
+    }
+    get props() {
+        return super.props;
+    }
     #observeEntityType() {
         if (!this.#entityType)
             return;
@@ -24,23 +32,52 @@ let UmbTreeItemElement = class UmbTreeItemElement extends UmbExtensionElementAnd
                 return false;
             return manifest.forEntityTypes.includes(this.#entityType);
         };
+        // Check if we can find a matching tree item for the current entity type.
+        // If we can, we will use that one, if not we will render a fallback tree item.
         this.observe(
         // TODO: what should we do if there are multiple tree items for an entity type?
         // This method gets all extensions based on a type, then filters them based on the entity type. and then we get the alias of the first one [NL]
         createObservablePart(umbExtensionsRegistry.byTypeAndFilter(this.getExtensionType(), filterByEntityType), (x) => x[0]?.alias), (alias) => {
             this.alias = alias;
+            // If we don't find any registered tree items for this specific entity type, we will render a fallback tree item.
+            // This is on purpose not done with the extension initializer since we don't want to spin up a real extension unless we have to.
+            if (!alias) {
+                this.#renderFallbackItem();
+            }
         }, 'umbObserveAlias');
     }
+    #renderFallbackItem() {
+        // TODO: make creating of elements with apis a shared function.
+        const element = document.createElement('umb-default-tree-item');
+        const api = new UmbDefaultTreeItemContext(element);
+        element.api = api;
+        this._element = element;
+        this.#assignProps();
+        this.requestUpdate('_element');
+    }
     getExtensionType() {
         return 'treeItem';
     }
     getDefaultElementName() {
         return 'umb-default-tree-item';
     }
+    #assignProps() {
+        if (!this._element || !this.props)
+            return;
+        Object.keys(this.props).forEach((key) => {
+            this._element[key] = this.props[key];
+        });
+    }
+    getDefaultApiConstructor() {
+        return UmbDefaultTreeItemContext;
+    }
 };
 __decorate([
     property({ type: String, reflect: true })
 ], UmbTreeItemElement.prototype, "entityType", null);
+__decorate([
+    property({ type: Object, attribute: false })
+], UmbTreeItemElement.prototype, "props", null);
 UmbTreeItemElement = __decorate([
     customElement('umb-tree-item')
 ], UmbTreeItemElement);

package/dist-cms/packages/core/tree/tree-menu-item/tree-menu-item.element.js

@@ -59,6 +59,7 @@ let UmbMenuItemTreeDefaultElement = class UmbMenuItemTreeDefaultElement extends
                     multiple: false,
                 },
                 expansion: this._menuItemExpansion,
+                isMenu: true,
             }}
 						@expansion-entry-expanded=${this.#onExpansionChange}
 						@expansion-entry-collapsed=${this.#onExpansionChange}></umb-tree>

package/dist-cms/packages/core/tree/tree-picker-modal/index.d.ts

@@ -1,3 +1,3 @@
 export { UMB_TREE_PICKER_MODAL_ALIAS } from './constants.js';
-export type { UmbTreePickerModalData, UmbTreePickerModalValue } from './tree-picker-modal.token.js';
 export { UMB_TREE_PICKER_MODAL } from './tree-picker-modal.token.js';
+export type * from './types.js';

package/dist-cms/packages/core/tree/tree-picker-modal/tree-picker-modal.element.d.ts

@@ -1,6 +1,6 @@
 import { UmbTreeItemPickerContext } from '../tree-item-picker/index.js';
 import type { UmbTreeItemModelBase } from '../types.js';
-import type { UmbTreePickerModalData, UmbTreePickerModalValue } from './tree-picker-modal.token.js';
+import type { UmbTreePickerModalData, UmbTreePickerModalValue } from './types.js';
 import { UmbPickerModalBaseElement } from '../../picker/index.js';
 import type { PropertyValueMap } from '../../../../external/lit/index.js';
 export declare class UmbTreePickerModalElement<TreeItemType extends UmbTreeItemModelBase> extends UmbPickerModalBaseElement<TreeItemType, UmbTreePickerModalData<TreeItemType>, UmbTreePickerModalValue> {

package/dist-cms/packages/core/tree/tree-picker-modal/tree-picker-modal.element.js

@@ -21,6 +21,7 @@ let UmbTreePickerModalElement = class UmbTreePickerModalElement extends UmbPicke
         this._hasSelection = false;
         this._treeExpansion = [];
         this._pickerContext = new UmbTreeItemPickerContext(this);
+        this.#searchSelectableFilter = () => true;
         this._pickerContext.selection.setSelectable(true);
         this.observe(this._pickerContext.selection.hasSelection, (hasSelection) => {
             this._hasSelection = hasSelection;
@@ -123,6 +124,7 @@ let UmbTreePickerModalElement = class UmbTreePickerModalElement extends UmbPicke
         const expansion = target.getExpansion();
         this._pickerContext.expansion.setExpansion(expansion);
     }
+    #searchSelectableFilter;
     render() {
         return html `
 			<umb-body-layout headline=${this.localize.term('general_choose')}>
@@ -132,9 +134,10 @@ let UmbTreePickerModalElement = class UmbTreePickerModalElement extends UmbPicke
 		`;
     }
     #renderSearch() {
+        const selectableFilter = this.data?.search?.pickableFilter ?? this.data?.pickableFilter ?? this.#searchSelectableFilter;
         return html `
 			<umb-picker-search-field></umb-picker-search-field>
-			<umb-picker-search-result .pickableFilter=${this.data?.pickableFilter}></umb-picker-search-result>
+			<umb-picker-search-result .pickableFilter=${selectableFilter}></umb-picker-search-result>
 		`;
     }
     #renderTree() {

package/dist-cms/packages/core/tree/tree-picker-modal/tree-picker-modal.token.d.ts

@@ -1,23 +1,3 @@
-import type { UmbTreeItemModel, UmbTreeStartNode } from '../types.js';
-import type { UmbPickerModalData, UmbPickerModalValue } from '../../modal/index.js';
-import type { UmbWorkspaceModalData } from '../../workspace/index.js';
+import type { UmbTreePickerModalData, UmbTreePickerModalValue } from './types.js';
 import { UmbModalToken } from '../../modal/index.js';
-import type { UmbPathPattern, UmbPathPatternParamsType } from '../../router/index.js';
-export interface UmbTreePickerModalCreateActionData<PathPatternParamsType extends UmbPathPatternParamsType> {
-    label: string;
-    modalData: UmbWorkspaceModalData;
-    modalToken?: UmbModalToken;
-    extendWithPathPattern: UmbPathPattern;
-    extendWithPathParams: PathPatternParamsType;
-}
-export interface UmbTreePickerModalData<TreeItemType = UmbTreeItemModel, PathPatternParamsType extends UmbPathPatternParamsType = UmbPathPatternParamsType> extends UmbPickerModalData<TreeItemType> {
-    hideTreeRoot?: boolean;
-    expandTreeRoot?: boolean;
-    treeAlias?: string;
-    createAction?: UmbTreePickerModalCreateActionData<PathPatternParamsType>;
-    startNode?: UmbTreeStartNode;
-    foldersOnly?: boolean;
-}
-export interface UmbTreePickerModalValue extends UmbPickerModalValue {
-}
-export declare const UMB_TREE_PICKER_MODAL: UmbModalToken<UmbTreePickerModalData<UmbTreeItemModel, UmbPathPatternParamsType>, UmbTreePickerModalValue>;
+export declare const UMB_TREE_PICKER_MODAL: UmbModalToken<UmbTreePickerModalData<import("../types.js").UmbTreeItemModel, import("../../router/path-pattern.class.js").UmbPathPatternParamsType>, UmbTreePickerModalValue>;

package/dist-cms/packages/core/tree/tree-picker-modal/types.d.ts

@@ -0,0 +1,21 @@
+import type { UmbTreeItemModel, UmbTreeStartNode } from '../types.js';
+import type { UmbPathPattern, UmbPathPatternParamsType } from '../../router/index.js';
+import type { UmbModalToken, UmbPickerModalData, UmbPickerModalValue } from '../../modal/index.js';
+import type { UmbWorkspaceModalData } from '../../workspace/index.js';
+export interface UmbTreePickerModalCreateActionData<PathPatternParamsType extends UmbPathPatternParamsType> {
+    label: string;
+    modalData: UmbWorkspaceModalData;
+    modalToken?: UmbModalToken;
+    extendWithPathPattern: UmbPathPattern;
+    extendWithPathParams: PathPatternParamsType;
+}
+export interface UmbTreePickerModalData<TreeItemType = UmbTreeItemModel, PathPatternParamsType extends UmbPathPatternParamsType = UmbPathPatternParamsType> extends UmbPickerModalData<TreeItemType> {
+    hideTreeRoot?: boolean;
+    expandTreeRoot?: boolean;
+    treeAlias?: string;
+    createAction?: UmbTreePickerModalCreateActionData<PathPatternParamsType>;
+    startNode?: UmbTreeStartNode;
+    foldersOnly?: boolean;
+}
+export interface UmbTreePickerModalValue extends UmbPickerModalValue {
+}

package/dist-cms/packages/core/tree/tree-picker-modal/types.js

@@ -0,0 +1 @@
+export {};

package/dist-cms/packages/core/tree/tree.context.interface.d.ts

@@ -0,0 +1,47 @@
+import type { ManifestTree, UmbTreeItemModel, UmbTreeRootModel, UmbTreeStartNode } from './types.js';
+import type { Observable } from '../../../libs/observable-api/index.js';
+import type { UmbContextBase } from '../../../libs/class-api/index.js';
+import type { UmbTreeExpansionManager } from './expansion-manager/index.js';
+import type { UmbTreeExpansionModel } from './expansion-manager/types.js';
+import type { UmbTreeItemActiveManager } from './active-manager/tree-active-manager.js';
+import type { UmbTreeRepository } from './data/tree-repository.interface.js';
+import type { UmbTreeRootItemsRequestArgs } from './data/types.js';
+import type { UmbPaginationManager, UmbSelectionManager, UmbTargetPaginationManager } from '../utils/index.js';
+export interface UmbTreeContext<TreeItemType extends UmbTreeItemModel = UmbTreeItemModel, TreeRootType extends UmbTreeRootModel = UmbTreeRootModel, RequestArgsType extends UmbTreeRootItemsRequestArgs = UmbTreeRootItemsRequestArgs> extends UmbContextBase {
+    manifest: ManifestTree | undefined;
+    readonly activeManager: UmbTreeItemActiveManager;
+    readonly treeRoot: Observable<TreeRootType | undefined>;
+    readonly hideTreeRoot: Observable<boolean | undefined>;
+    readonly expandTreeRoot: Observable<boolean | undefined>;
+    selectableFilter?(item: TreeItemType): boolean;
+    filter?(item: TreeItemType): boolean;
+    readonly selection: UmbSelectionManager;
+    readonly expansion: UmbTreeExpansionManager;
+    readonly rootItems: Observable<TreeItemType[]>;
+    readonly hasChildren: Observable<boolean>;
+    readonly pagination: UmbPaginationManager;
+    readonly targetPagination: UmbTargetPaginationManager;
+    readonly startNode: Observable<UmbTreeStartNode | undefined>;
+    readonly foldersOnly: Observable<boolean>;
+    readonly additionalRequestArgs: Observable<Partial<RequestArgsType> | object>;
+    readonly isLoadingPrevChildren: Observable<boolean>;
+    readonly isLoadingNextChildren: Observable<boolean>;
+    getRepository(): UmbTreeRepository | undefined;
+    loadTree(): void;
+    reloadTree(): void;
+    loadMore(): void;
+    loadPrevItems(): void;
+    loadNextItems(): void;
+    setHideTreeRoot(hideTreeRoot: boolean): void;
+    getHideTreeRoot(): boolean;
+    setStartNode(startNode: UmbTreeStartNode | undefined): void;
+    getStartNode(): UmbTreeStartNode | undefined;
+    setFoldersOnly(foldersOnly: boolean): void;
+    getFoldersOnly(): boolean;
+    updateAdditionalRequestArgs(args: Partial<RequestArgsType>): void;
+    getAdditionalRequestArgs(): Partial<RequestArgsType> | undefined;
+    setExpansion(data: UmbTreeExpansionModel): void;
+    getExpansion(): UmbTreeExpansionModel;
+    setExpandTreeRoot(expandTreeRoot: boolean): void;
+    getExpandTreeRoot(): boolean | undefined;
+}

package/dist-cms/packages/core/tree/tree.context.interface.js

@@ -0,0 +1 @@
+export {};

package/dist-cms/packages/core/tree/tree.context.token.d.ts

@@ -0,0 +1,4 @@
+import type { UmbTreeItemModel, UmbTreeRootModel } from './types.js';
+import type { UmbTreeContext } from './tree.context.interface.js';
+import { UmbContextToken } from '../../../libs/context-api/index.js';
+export declare const UMB_TREE_CONTEXT: UmbContextToken<UmbTreeContext<UmbTreeItemModel, UmbTreeRootModel, import("./index.js").UmbTreeRootItemsRequestArgs>, UmbTreeContext<UmbTreeItemModel, UmbTreeRootModel, import("./index.js").UmbTreeRootItemsRequestArgs>>;

package/dist-cms/packages/core/tree/tree.context.token.js

@@ -0,0 +1,2 @@
+import { UmbContextToken } from '../../../libs/context-api/index.js';
+export const UMB_TREE_CONTEXT = new UmbContextToken('UmbTreeContext');

package/dist-cms/packages/core/tree/types.d.ts

@@ -1,9 +1,10 @@
 import type { UmbEntityModel } from '../entity/index.js';
+import type { UmbEntityWithOptionalFlags } from '../entity-flag/index.js';
 export type * from './entity-actions/types.js';
 export type * from './extensions/types.js';
 export type * from './folder/types.js';
 export type * from './tree-menu-item/types.js';
-export interface UmbTreeItemModelBase extends UmbEntityModel {
+export interface UmbTreeItemModelBase extends UmbEntityWithOptionalFlags {
     name: string;
     hasChildren: boolean;
     isFolder: boolean;

package/dist-cms/packages/core/utils/config-collection/index.d.ts

@@ -0,0 +1,8 @@
+import type { UmbConfigCollectionModel } from './types.js';
+/**
+ * Get a value from a config collection by its alias.
+ * @param {UmbConfigCollectionModel | undefined} config - The config collection to get the value from.
+ * @param {string} alias - The alias of the value to get.
+ * @returns {T | undefined} The value with the specified alias, or undefined if not found or if the config is undefined.
+ */
+export declare function getConfigValue<T>(config: UmbConfigCollectionModel | undefined, alias: string): T | undefined;

package/dist-cms/packages/core/utils/config-collection/index.js

@@ -0,0 +1,10 @@
+/**
+ * Get a value from a config collection by its alias.
+ * @param {UmbConfigCollectionModel | undefined} config - The config collection to get the value from.
+ * @param {string} alias - The alias of the value to get.
+ * @returns {T | undefined} The value with the specified alias, or undefined if not found or if the config is undefined.
+ */
+export function getConfigValue(config, alias) {
+    const entry = config?.find((entry) => entry.alias === alias);
+    return entry?.value;
+}

package/dist-cms/packages/core/utils/config-collection/types.d.ts

@@ -0,0 +1,5 @@
+export interface UmbConfigCollectionEntryModel {
+    alias: string;
+    value: unknown;
+}
+export type UmbConfigCollectionModel = Array<UmbConfigCollectionEntryModel>;

package/dist-cms/packages/core/utils/config-collection/types.js

@@ -0,0 +1 @@
+export {};

package/dist-cms/packages/core/utils/date/date.timezone.d.ts

@@ -0,0 +1,38 @@
+import type { DateTime } from '../../../../external/luxon/index.js';
+export interface UmbTimeZone {
+    value: string;
+    name: string;
+}
+/**
+ * Retrieves a list of supported time zones in the browser.
+ * @param {Array<string>} [filter] - An optional array of time zone identifiers to filter the result on.
+ * @returns {Array<UmbTimeZone>} An array of objects containing time zone values and names.
+ */
+export declare function getTimeZoneList(filter?: Array<string> | undefined): Array<UmbTimeZone>;
+/**
+ * Retrieves the client's time zone information.
+ * @param {DateTime} [selectedDate] - An optional Luxon DateTime object to format the offset of the time zone.
+ * @returns {UmbTimeZone} An object containing the client's time zone name and value.
+ */
+export declare function getClientTimeZone(): UmbTimeZone;
+/**
+ * Returns the time zone offset for a given time zone ID and date.
+ * @param timeZoneId - The time zone identifier (e.g., 'America/New_York').
+ * @param date - The Luxon DateTime object for which to get the offset.
+ * @returns {string} The time zone offset
+ */
+export declare function getTimeZoneOffset(timeZoneId: string, date: DateTime): string;
+/**
+ * Returns the browser's time zone name in a user-friendly format.
+ * @param {string} timeZoneId - The time zone identifier.
+ * @returns {string} A formatted time zone name.
+ */
+export declare function getTimeZoneName(timeZoneId: string): string;
+/**
+ * Checks if two time zone identifiers are equivalent.
+ * This function compares the resolved time zone names to determine if they are equivalent.
+ * @param {string} tz1 - The first time zone identifier.
+ * @param {string} tz2 - The second time zone identifier.
+ * @returns {boolean} True if the time zones are equivalent, false otherwise.
+ */
+export declare function isEquivalentTimeZone(tz1: string, tz2: string): boolean;

package/dist-cms/packages/core/utils/date/date.timezone.js

@@ -0,0 +1,69 @@
+/**
+ * Retrieves a list of supported time zones in the browser.
+ * @param {Array<string>} [filter] - An optional array of time zone identifiers to filter the result on.
+ * @returns {Array<UmbTimeZone>} An array of objects containing time zone values and names.
+ */
+export function getTimeZoneList(filter = undefined) {
+    if (filter) {
+        return filter.map((tz) => ({
+            value: tz,
+            name: getTimeZoneName(tz),
+        }));
+    }
+    const timeZones = Intl.supportedValuesOf('timeZone')
+        // Exclude offset time zones, e.g. 'Etc/GMT+2', as they are not consistent between browsers
+        .filter((value) => value !== 'UTC' && !value.startsWith('Etc/'));
+    // Add UTC to the top of the list
+    timeZones.unshift('UTC');
+    return timeZones.map((tz) => ({
+        value: tz,
+        name: getTimeZoneName(tz),
+    }));
+}
+/**
+ * Retrieves the client's time zone information.
+ * @param {DateTime} [selectedDate] - An optional Luxon DateTime object to format the offset of the time zone.
+ * @returns {UmbTimeZone} An object containing the client's time zone name and value.
+ */
+export function getClientTimeZone() {
+    const clientTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return {
+        value: clientTimeZone,
+        name: getTimeZoneName(clientTimeZone),
+    };
+}
+/**
+ * Returns the time zone offset for a given time zone ID and date.
+ * @param timeZoneId - The time zone identifier (e.g., 'America/New_York').
+ * @param date - The Luxon DateTime object for which to get the offset.
+ * @returns {string} The time zone offset
+ */
+export function getTimeZoneOffset(timeZoneId, date) {
+    return date.setZone(timeZoneId).toFormat('Z');
+}
+/**
+ * Returns the browser's time zone name in a user-friendly format.
+ * @param {string} timeZoneId - The time zone identifier.
+ * @returns {string} A formatted time zone name.
+ */
+export function getTimeZoneName(timeZoneId) {
+    if (timeZoneId === 'UTC') {
+        return 'Coordinated Universal Time (UTC)';
+    }
+    return timeZoneId.replaceAll('_', ' ');
+}
+/**
+ * Checks if two time zone identifiers are equivalent.
+ * This function compares the resolved time zone names to determine if they are equivalent.
+ * @param {string} tz1 - The first time zone identifier.
+ * @param {string} tz2 - The second time zone identifier.
+ * @returns {boolean} True if the time zones are equivalent, false otherwise.
+ */
+export function isEquivalentTimeZone(tz1, tz2) {
+    if (tz1 === tz2) {
+        return true;
+    }
+    const tz1Name = new Intl.DateTimeFormat(undefined, { timeZone: tz1 }).resolvedOptions().timeZone;
+    const tz2Name = new Intl.DateTimeFormat(undefined, { timeZone: tz2 }).resolvedOptions().timeZone;
+    return tz1Name === tz2Name;
+}

package/dist-cms/packages/core/utils/date/index.d.ts

@@ -0,0 +1 @@
+export * from './date.timezone.js';

package/dist-cms/packages/core/utils/date/index.js

@@ -0,0 +1 @@
+export * from './date.timezone.js';

package/dist-cms/packages/core/utils/expansion/entity-expansion.manager.d.ts

@@ -17,6 +17,13 @@ export declare class UmbEntityExpansionManager<EntryModelType extends UmbEntityE
      * @memberof UmbEntityExpansionManager
      */
     isExpanded(entity: EntryModelType): Observable<boolean>;
+    /**
+     * Observe the expansion entry for a specific entity
+     * @param {EntryModelType} entity The entity to observe
+     * @returns {Observable<EntryModelType | undefined>} An observable of the expansion entry
+     * @memberof UmbEntityExpansionManager
+     */
+    entry(entity: EntryModelType): Observable<EntryModelType | undefined>;
     /**
      * Sets the expansion state
      * @param {UmbEntityExpansionModel<EntryModelType> | undefined} expansion The expansion state
@@ -64,4 +71,11 @@ export declare class UmbEntityExpansionManager<EntryModelType extends UmbEntityE
      * @returns {Promise<void>}
      */
     collapseAll(): Promise<void>;
+    /**
+     * Gets an item from the expansion state
+     * @param {EntryModelType} entity The entity to get
+     * @returns {*}  {(Promise<UmbEntityExpansionEntryModel | undefined>)}
+     * @memberof UmbEntityExpansionManager
+     */
+    getItem(entity: EntryModelType): Promise<EntryModelType | undefined>;
 }

package/dist-cms/packages/core/utils/expansion/entity-expansion.manager.js

@@ -22,6 +22,15 @@ export class UmbEntityExpansionManager extends UmbControllerBase {
     isExpanded(entity) {
         return this._expansion.asObservablePart((entries) => entries?.some((entry) => entry.entityType === entity.entityType && entry.unique === entity.unique));
     }
+    /**
+     * Observe the expansion entry for a specific entity
+     * @param {EntryModelType} entity The entity to observe
+     * @returns {Observable<EntryModelType | undefined>} An observable of the expansion entry
+     * @memberof UmbEntityExpansionManager
+     */
+    entry(entity) {
+        return this._expansion.asObservablePart((entries) => entries?.find((entry) => entry.entityType === entity.entityType && entry.unique === entity.unique));
+    }
     /**
      * Sets the expansion state
      * @param {UmbEntityExpansionModel<EntryModelType> | undefined} expansion The expansion state
@@ -101,4 +110,14 @@ export class UmbEntityExpansionManager extends UmbControllerBase {
         this._expansion.setValue([]);
         this.getHostElement()?.dispatchEvent(new UmbExpansionChangeEvent());
     }
+    /**
+     * Gets an item from the expansion state
+     * @param {EntryModelType} entity The entity to get
+     * @returns {*}  {(Promise<UmbEntityExpansionEntryModel | undefined>)}
+     * @memberof UmbEntityExpansionManager
+     */
+    async getItem(entity) {
+        const expansion = this._expansion.getValue();
+        return expansion.find((x) => x.entityType === entity.entityType && x.unique === entity.unique);
+    }
 }

package/dist-cms/packages/core/utils/index.d.ts

@@ -1,5 +1,7 @@
 export * from './array/index.js';
 export * from './bytes/bytes.function.js';
+export * from './config-collection/index.js';
+export * from './date/index.js';
 export * from './debounce/debounce.function.js';
 export * from './deprecation/index.js';
 export * from './diff/index.js';
@@ -9,10 +11,12 @@ export * from './expansion/index.js';
 export * from './get-guid-from-udi.function.js';
 export * from './get-processed-image-url.function.js';
 export * from './guard-manager/index.js';
+export * from './is-test-environment.function.js';
 export * from './math/math.js';
 export * from './media/image-size.function.js';
 export * from './object/deep-merge.function.js';
 export * from './pagination-manager/pagination.manager.js';
+export * from './pagination/index.js';
 export * from './path/ensure-local-path.function.js';
 export * from './path/ensure-path-ends-with-slash.function.js';
 export * from './path/has-own-opener.function.js';
@@ -30,5 +34,4 @@ export * from './sanitize/sanitize-html.function.js';
 export * from './selection-manager/selection.manager.js';
 export * from './state-manager/index.js';
 export * from './string/index.js';
-export * from './is-test-environment.function.js';
 export type * from './type/index.js';

package/dist-cms/packages/core/utils/index.js

@@ -1,5 +1,7 @@
 export * from './array/index.js';
 export * from './bytes/bytes.function.js';
+export * from './config-collection/index.js';
+export * from './date/index.js';
 export * from './debounce/debounce.function.js';
 export * from './deprecation/index.js';
 export * from './diff/index.js';
@@ -9,10 +11,12 @@ export * from './expansion/index.js';
 export * from './get-guid-from-udi.function.js';
 export * from './get-processed-image-url.function.js';
 export * from './guard-manager/index.js';
+export * from './is-test-environment.function.js';
 export * from './math/math.js';
 export * from './media/image-size.function.js';
 export * from './object/deep-merge.function.js';
 export * from './pagination-manager/pagination.manager.js';
+export * from './pagination/index.js';
 export * from './path/ensure-local-path.function.js';
 export * from './path/ensure-path-ends-with-slash.function.js';
 export * from './path/has-own-opener.function.js';
@@ -30,4 +34,3 @@ export * from './sanitize/sanitize-html.function.js';
 export * from './selection-manager/selection.manager.js';
 export * from './state-manager/index.js';
 export * from './string/index.js';
-export * from './is-test-environment.function.js';

package/dist-cms/packages/core/utils/pagination/index.d.ts

@@ -0,0 +1,3 @@
+export * from './offset/index.js';
+export * from './target/index.js';
+export type * from './types.js';

package/dist-cms/packages/core/utils/pagination/index.js

@@ -0,0 +1,2 @@
+export * from './offset/index.js';
+export * from './target/index.js';

package/dist-cms/packages/core/utils/pagination/offset/index.d.ts

@@ -0,0 +1 @@
+export * from './is-offset-request.guard.js';

package/dist-cms/packages/core/utils/pagination/offset/index.js

@@ -0,0 +1 @@
+export * from './is-offset-request.guard.js';