@umbraco-cms/backoffice 18.1.1 → 18.2.0-rc

package/dist-cms/packages/core/interaction-memory/interaction-memory-scope.context.js

@@ -0,0 +1,29 @@
+import { UMB_INTERACTION_MEMORY_SCOPE_CONTEXT } from './interaction-memory-scope.context.token.js';
+import { UmbInteractionMemoryManager } from './interaction-memory.manager.js';
+import { UmbContextBase } from '../../../libs/class-api/index.js';
+/**
+ * One scope of interaction memory, for the modals opened from here. A modal is rendered in the modal
+ * portal rather than as a descendant of whatever opened it, so this context is how the two reach each
+ * other — see `UmbModalInteractionMemoryController`.
+ *
+ * Scopes nest: consumers resolve the nearest one, so each layer can hold its children's memories under
+ * a single key of its own and no layer needs to know another layer's keys. Distinct from
+ * `UMB_INTERACTION_MEMORY_CONTEXT`, which is the single page-wide store a scope's memories eventually
+ * reach.
+ * @exports
+ * @class UmbInteractionMemoryScopeContext
+ * @augments {UmbContextBase}
+ */
+export class UmbInteractionMemoryScopeContext extends UmbContextBase {
+    /**
+     * Creates an instance of UmbInteractionMemoryScopeContext.
+     * @param {UmbControllerHost} host - The host for the controller.
+     * @param {UmbInteractionMemoryManager} [memory] - The manager to expose as this scope. Pass one when
+     * the owner already holds a manager of its own; otherwise the scope creates one.
+     * @memberof UmbInteractionMemoryScopeContext
+     */
+    constructor(host, memory) {
+        super(host, UMB_INTERACTION_MEMORY_SCOPE_CONTEXT);
+        this.memory = memory ?? new UmbInteractionMemoryManager(this);
+    }
+}

package/dist-cms/packages/core/interaction-memory/interaction-memory-scope.context.token.d.ts

@@ -0,0 +1,3 @@
+import type { UmbInteractionMemoryScopeContext } from './interaction-memory-scope.context.js';
+import { UmbContextToken } from '../../../libs/context-api/index.js';
+export declare const UMB_INTERACTION_MEMORY_SCOPE_CONTEXT: UmbContextToken<UmbInteractionMemoryScopeContext, UmbInteractionMemoryScopeContext>;

package/dist-cms/packages/core/interaction-memory/interaction-memory-scope.context.token.js

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

package/dist-cms/packages/core/interaction-memory/interaction-memory.manager.d.ts

@@ -37,6 +37,14 @@ export declare class UmbInteractionMemoryManager extends UmbControllerBase {
      * @memberof UmbInteractionMemoryManager
      */
     deleteMemory(unique: string): void;
+    /**
+     * Replace all memory items with the given list: items no longer present are removed, the rest are
+     * added or updated. The underlying state only notifies observers when the content actually
+     * changes, so this emits at most once regardless of how many items differ.
+     * @param {Array<UmbInteractionMemoryModel>} memories - The authoritative list of memory items to hold.
+     * @memberof UmbInteractionMemoryManager
+     */
+    setMemories(memories: Array<UmbInteractionMemoryModel>): void;
     /**
      * Get all memory items from the manager.
      * @returns {Array<UmbInteractionMemoryModel>} An array of all memory items.

package/dist-cms/packages/core/interaction-memory/interaction-memory.manager.js

@@ -48,6 +48,16 @@ export class UmbInteractionMemoryManager extends UmbControllerBase {
     deleteMemory(unique) {
         this.#memories.removeOne(unique);
     }
+    /**
+     * Replace all memory items with the given list: items no longer present are removed, the rest are
+     * added or updated. The underlying state only notifies observers when the content actually
+     * changes, so this emits at most once regardless of how many items differ.
+     * @param {Array<UmbInteractionMemoryModel>} memories - The authoritative list of memory items to hold.
+     * @memberof UmbInteractionMemoryManager
+     */
+    setMemories(memories) {
+        this.#memories.setValue(memories);
+    }
     /**
      * Get all memory items from the manager.
      * @returns {Array<UmbInteractionMemoryModel>} An array of all memory items.

package/dist-cms/packages/core/interaction-memory/modal-interaction-memory.controller.d.ts

@@ -0,0 +1,40 @@
+import type { UmbInteractionMemoryManager } from './interaction-memory.manager.js';
+import { UmbControllerBase } from '../../../libs/class-api/index.js';
+import type { UmbControllerHost } from '../../../libs/controller-api/index.js';
+export interface UmbModalInteractionMemoryControllerArgs {
+    /**
+     * The memory manager holding the modal's own memories. Everything it holds is published to the
+     * scope above as one entry, and it is the scope for any modal opened from this one. Pass a function
+     * when the manager does not exist yet at construction time, e.g. when a base class sets this up for
+     * a manager owned by its subclass.
+     */
+    memory: UmbInteractionMemoryManager | (() => UmbInteractionMemoryManager);
+    /**
+     * The key the modal publishes its memories under. Pass a function when the key is not known at
+     * construction time, e.g. when it derives from the modal manifest. Nothing is bridged while it
+     * resolves to undefined.
+     */
+    unique: string | (() => string | undefined);
+}
+/**
+ * Bridges a modal's own interaction-memory manager to the nearest scope above it, and makes that
+ * manager the scope for modals opened from this one — so each modal's memories nest under a single
+ * key of its own choosing and no layer needs to know another layer's keys.
+ *
+ * A modal is rendered in the modal portal rather than as a descendant of whatever opened it, so
+ * context is the only channel available across that boundary.
+ * @exports
+ * @class UmbModalInteractionMemoryController
+ * @augments {UmbControllerBase}
+ */
+export declare class UmbModalInteractionMemoryController extends UmbControllerBase {
+    #private;
+    /**
+     * Creates an instance of UmbModalInteractionMemoryController.
+     * @param {UmbControllerHost} host - The modal element to bridge.
+     * @param {UmbModalInteractionMemoryControllerArgs} args - The manager to bridge and the key to publish it under.
+     * @memberof UmbModalInteractionMemoryController
+     */
+    constructor(host: UmbControllerHost, args: UmbModalInteractionMemoryControllerArgs);
+    hostConnected(): void;
+}

package/dist-cms/packages/core/interaction-memory/modal-interaction-memory.controller.js

@@ -0,0 +1,83 @@
+import { UMB_INTERACTION_MEMORY_SCOPE_CONTEXT } from './interaction-memory-scope.context.token.js';
+import { UmbInteractionMemoryScopeContext } from './interaction-memory-scope.context.js';
+import { UmbControllerBase } from '../../../libs/class-api/index.js';
+/**
+ * Bridges a modal's own interaction-memory manager to the nearest scope above it, and makes that
+ * manager the scope for modals opened from this one — so each modal's memories nest under a single
+ * key of its own choosing and no layer needs to know another layer's keys.
+ *
+ * A modal is rendered in the modal portal rather than as a descendant of whatever opened it, so
+ * context is the only channel available across that boundary.
+ * @exports
+ * @class UmbModalInteractionMemoryController
+ * @augments {UmbControllerBase}
+ */
+export class UmbModalInteractionMemoryController extends UmbControllerBase {
+    #memoryArg;
+    #memory;
+    #unique;
+    #scope;
+    /**
+     * Creates an instance of UmbModalInteractionMemoryController.
+     * @param {UmbControllerHost} host - The modal element to bridge.
+     * @param {UmbModalInteractionMemoryControllerArgs} args - The manager to bridge and the key to publish it under.
+     * @memberof UmbModalInteractionMemoryController
+     */
+    constructor(host, args) {
+        super(host);
+        this.#memoryArg = args.memory;
+        this.#unique = args.unique;
+    }
+    // Wired up on connect rather than in the constructor, and before `super.hostConnected()` so the
+    // controllers below are connected synchronously by it. Both matter: a modal reads its restored
+    // memories synchronously in `firstUpdated`, so the seed has to have landed by then — anything that
+    // defers this to a later microtask makes the modal open on stale state.
+    hostConnected() {
+        if (!this.#memory) {
+            this.#memory = typeof this.#memoryArg === 'function' ? this.#memoryArg() : this.#memoryArg;
+            // Exposed as a scope of its own, so modals opened from this one nest inside this modal's entry.
+            new UmbInteractionMemoryScopeContext(this, this.#memory);
+            this.observe(this.#memory.memories, (memories) => {
+                this.#publishToScope(memories);
+            }, 'umbModalInteractionMemoryPublishObserver');
+            // `skipHost` so this resolves the scope above the modal rather than the one provided here.
+            this.consumeContext(UMB_INTERACTION_MEMORY_SCOPE_CONTEXT, (scope) => {
+                this.#scope = scope?.memory;
+                this.#observeScope();
+                // The scope can arrive after the modal already holds memories, in which case there is no
+                // further change to publish on.
+                this.#publishToScope(this.#memory.getAllMemories());
+            }).skipHost();
+        }
+        super.hostConnected();
+    }
+    #getUnique() {
+        return typeof this.#unique === 'function' ? this.#unique() : this.#unique;
+    }
+    // Reads `unique` once, at the point the scope resolves — deliberately not deferred (see the
+    // `hostConnected` comment above). This relies on `unique` already being resolvable by then, which
+    // holds for every current caller: a function-valued `unique` reads state (e.g. `manifest.alias`)
+    // that is assigned before the modal element connects, never after. A caller that can only supply
+    // `unique` after connecting is not supported by this controller.
+    #observeScope() {
+        const unique = this.#getUnique();
+        this.observe(unique ? this.#scope?.memory(unique) : undefined, (memory) => {
+            // Seed only. While the modal is open it is the sole author of its own entry, so an absent
+            // entry means "nothing stored yet" or teardown — never "forget what you have".
+            if (!memory)
+                return;
+            this.#memory?.setMemories(memory.memories ?? []);
+        }, 'umbModalInteractionMemorySeedObserver');
+    }
+    #publishToScope(memories) {
+        const unique = this.#getUnique();
+        if (!unique)
+            return;
+        if (memories.length > 0) {
+            this.#scope?.setMemory({ unique, memories });
+        }
+        else {
+            this.#scope?.deleteMemory(unique);
+        }
+    }
+}

package/dist-cms/packages/core/lit-element/directives/destroy.lit-directive.d.ts

@@ -12,7 +12,7 @@ declare class UmbDestroyDirective extends AsyncDirective {
 /**
  * @description
  * A Lit directive, which destroys the element once its disconnected from the DOM.
- * @example:
+ * @example
  * ```js
  * html`<input ${umbDestroyOnDisconnect()}>`;
  * ```

package/dist-cms/packages/core/lit-element/directives/destroy.lit-directive.js

@@ -35,7 +35,7 @@ class UmbDestroyDirective extends AsyncDirective {
 /**
  * @description
  * A Lit directive, which destroys the element once its disconnected from the DOM.
- * @example:
+ * @example
  * ```js
  * html`<input ${umbDestroyOnDisconnect()}>`;
  * ```

package/dist-cms/packages/core/lit-element/directives/focus.lit-directive.d.ts

@@ -11,7 +11,7 @@ declare class UmbFocusDirective extends AsyncDirective {
 /**
  * @description
  * A Lit directive, which sets focus on the element of scope once its connected to the DOM.
- * @example:
+ * @example
  * ```js
  * html`<input ${umbFocus()}>`;
  * ```

package/dist-cms/packages/core/lit-element/directives/focus.lit-directive.js

@@ -4,9 +4,9 @@ import { AsyncDirective, directive, nothing } from '../../../../external/lit/ind
  *
  * test if a element has focus
  * this also returns true if the focused element is a child of the target.
- * @param current
- * @param target
- * @returns bool
+ * @param {Element | null} current - The element to check, starting point of the recursive search
+ * @param {HTMLElement} target - The element to test for focus
+ * @returns {boolean} bool
  */
 function hasFocus(current, target) {
     if (current === target) {
@@ -74,7 +74,7 @@ _a = UmbFocusDirective;
 /**
  * @description
  * A Lit directive, which sets focus on the element of scope once its connected to the DOM.
- * @example:
+ * @example
  * ```js
  * html`<input ${umbFocus()}>`;
  * ```

package/dist-cms/packages/core/localization/components/ui-culture-input/ui-culture-input.element.js

@@ -39,9 +39,9 @@ let UmbUiCultureInputElement = class UmbUiCultureInputElement extends UmbFormCon
             });
             const distinct = [...new Map(options.map((item) => [item.value, item])).values()];
             this._options = distinct.sort((a, b) => a.name.localeCompare(b.name));
-        }, 'umbObserveLocalizationManifests');
-        this.addValidator('customError', () => this.localize.term('user_languageNotFound', this.#invalidCulture, this.value), () => !!this.#invalidCulture && !this.#invalidBaseCulture);
-        this.addValidator('customError', () => this.localize.term('user_languageNotFoundFallback', this.#invalidCulture, this.#invalidBaseCulture), () => !!this.#invalidCulture && !!this.#invalidBaseCulture);
+        }, null);
+        this.addValidator('customError', () => this.localize.term('user_languageNotFound', this.#invalidCulture ?? '', this.value ?? ''), () => !!this.#invalidCulture && !this.#invalidBaseCulture);
+        this.addValidator('customError', () => this.localize.term('user_languageNotFoundFallback', this.#invalidCulture ?? '', this.#invalidBaseCulture ?? ''), () => !!this.#invalidCulture && !!this.#invalidBaseCulture);
     }
     firstUpdated(_changedProperties) {
         super.firstUpdated(_changedProperties);

package/dist-cms/packages/core/localization/localize-number.element.d.ts

@@ -18,7 +18,7 @@ export declare class UmbLocalizeNumberElement extends UmbLitElement {
      */
     options?: Intl.NumberFormatOptions;
     protected get text(): string | null;
-    render(): import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective> | import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1> | import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective>;
     static styles: import("lit").CSSResult[];
 }
 declare global {

package/dist-cms/packages/core/localization/localize-relative-time.element.d.ts

@@ -24,7 +24,7 @@ export declare class UmbLocalizeRelativeTimeElement extends UmbLitElement {
      */
     unit: Intl.RelativeTimeFormatUnit;
     protected get text(): string | null;
-    render(): import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective> | import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1> | import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective>;
     static styles: import("lit").CSSResult[];
 }
 declare global {

package/dist-cms/packages/core/localization/localize.element.d.ts

@@ -1,3 +1,4 @@
+import '../../../libs/localization-api/index.js';
 import { UmbLitElement } from '../lit-element/index.js';
 /**
  * This element allows you to localize a string with optional interpolation values.
@@ -7,10 +8,14 @@ import { UmbLitElement } from '../lit-element/index.js';
 export declare class UmbLocalizeElement extends UmbLitElement {
     /**
      * The key to localize. The key is case sensitive.
+     *
+     * Typed as `UmbKnownLocalizationKey | (string & {})` so that property bindings get
+     * autocomplete for the canonical `en.ts` dictionary while still accepting dynamic
+     * keys (e.g., `` `login_greeting${day}` ``) and third-party-augmented entries.
      * @attr
      * @example key="general_ok"
      */
-    key: string;
+    key: UmbKnownLocalizationKey | (string & {});
     /**
      * The values to forward to the localization function (must be JSON compatible).
      * @attr
@@ -24,7 +29,7 @@ export declare class UmbLocalizeElement extends UmbLitElement {
      */
     debug: boolean;
     protected get text(): string | null;
-    render(): import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective> | import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1> | import("lit-html/directive.js").DirectiveResult<typeof import("lit-html/directives/unsafe-html.js").UnsafeHTMLDirective>;
     static styles: import("lit").CSSResult[];
 }
 declare global {

package/dist-cms/packages/core/localization/localize.element.js

@@ -6,6 +6,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { css, customElement, html, property, state, unsafeHTML, when } from '../../../external/lit/index.js';
 import { escapeHTML } from '../utils/index.js';
+// Side-effect import: ensures the global `UmbKnownLocalizationKey` declaration is loaded so the
+// `key` property below picks up plugin-augmented entries from `declare global` blocks.
+import '../../../libs/localization-api/index.js';
 import { UmbLitElement } from '../lit-element/index.js';
 /**
  * This element allows you to localize a string with optional interpolation values.

package/dist-cms/packages/core/menu/components/menu-item/expansion/menu-item-expansion.manager.d.ts

@@ -18,26 +18,26 @@ export declare class UmbMenuItemExpansionManager extends UmbControllerBase {
      * Checks if an entry is expanded
      * @param {UmbMenuItemExpansionEntryModel} entry The entry to check
      * @returns {Observable<boolean>} True if the entry is expanded
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      */
     isExpanded(entry: UmbMenuItemExpansionEntryModel): Observable<boolean>;
     /**
      * Sets the expansion state
      * @param {UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel> | undefined} expansion The expansion state
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {void}
      */
     setExpansion(expansion: UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel>): void;
     /**
      * Gets the expansion state
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel>} The expansion state
      */
     getExpansion(): UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel>;
     /**
      * Opens a menu item
      * @param {UmbMenuItemExpansionEntryModel} entry The item to open
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     expandItem(entry: UmbMenuItemExpansionEntryModel): Promise<void>;
@@ -51,13 +51,13 @@ export declare class UmbMenuItemExpansionManager extends UmbControllerBase {
     /**
      * Closes a menu item
      * @param {UmbMenuItemExpansionEntryModel} entry The item to close
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     collapseItem(entry: UmbMenuItemExpansionEntryModel): Promise<void>;
     /**
      * Closes all menu items
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     collapseAll(): Promise<void>;

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

@@ -39,7 +39,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
      * Checks if an entry is expanded
      * @param {UmbMenuItemExpansionEntryModel} entry The entry to check
      * @returns {Observable<boolean>} True if the entry is expanded
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      */
     isExpanded(entry) {
         return this.#manager.isExpanded(entry);
@@ -47,7 +47,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
     /**
      * Sets the expansion state
      * @param {UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel> | undefined} expansion The expansion state
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {void}
      */
     setExpansion(expansion) {
@@ -56,7 +56,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
     }
     /**
      * Gets the expansion state
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {UmbEntityExpansionModel<UmbMenuItemExpansionEntryModel>} The expansion state
      */
     getExpansion() {
@@ -65,7 +65,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
     /**
      * Opens a menu item
      * @param {UmbMenuItemExpansionEntryModel} entry The item to open
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     async expandItem(entry) {
@@ -85,7 +85,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
     /**
      * Closes a menu item
      * @param {UmbMenuItemExpansionEntryModel} entry The item to close
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     async collapseItem(entry) {
@@ -94,7 +94,7 @@ export class UmbMenuItemExpansionManager extends UmbControllerBase {
     }
     /**
      * Closes all menu items
-     * @memberof UmbSectionSidebarMenuSectionExpansionManager
+     * @memberof UmbMenuItemExpansionManager
      * @returns {Promise<void>}
      */
     async collapseAll() {

package/dist-cms/packages/core/menu/components/menu-item/link/link-menu-item.element.d.ts

@@ -1,7 +1,6 @@
 import type { UmbMenuItemElement } from '../menu-item-element.interface.js';
 import type { ManifestMenuItemLinkKind } from './types.js';
 import { UmbLitElement } from '../../../../lit-element/index.js';
-declare const elementName = "umb-link-menu-item";
 export declare class UmbLinkMenuItemElement extends UmbLitElement implements UmbMenuItemElement {
     #private;
     manifest?: ManifestMenuItemLinkKind;
@@ -10,6 +9,6 @@ export declare class UmbLinkMenuItemElement extends UmbLitElement implements Umb
 export { UmbLinkMenuItemElement as element };
 declare global {
     interface HTMLElementTagNameMap {
-        [elementName]: UmbLinkMenuItemElement;
+        'umb-link-menu-item': UmbLinkMenuItemElement;
     }
 }

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

@@ -6,7 +6,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { customElement, html, property } from '../../../../../../external/lit/index.js';
 import { UmbLitElement } from '../../../../lit-element/index.js';
-const elementName = 'umb-link-menu-item';
 let UmbLinkMenuItemElement = class UmbLinkMenuItemElement extends UmbLitElement {
     #getTarget() {
         const href = this.manifest?.meta.href;
@@ -30,7 +29,7 @@ __decorate([
     property({ type: Object, attribute: false })
 ], UmbLinkMenuItemElement.prototype, "manifest", void 0);
 UmbLinkMenuItemElement = __decorate([
-    customElement(elementName)
+    customElement('umb-link-menu-item')
 ], UmbLinkMenuItemElement);
 export { UmbLinkMenuItemElement };
 export { UmbLinkMenuItemElement as element };

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

@@ -4,7 +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 { customElement, html, ifDefined, property, state, when, } from '../../../../../external/lit/index.js';
+import { customElement, html, ifDefined, property, state, when } from '../../../../../external/lit/index.js';
 import { UmbLitElement } from '../../../lit-element/index.js';
 import { ensureSlash } from '../../../router/index.js';
 import { debounce } from '../../../utils/index.js';

package/dist-cms/packages/core/menu/conditions/menu-alias.condition.d.ts

@@ -1,5 +1,5 @@
-import { UmbConditionBase } from '../../extension-registry/index.js';
 import type { MenuAliasConditionConfig } from './types.js';
+import { UmbConditionBase } from '../../extension-registry/index.js';
 import type { UmbControllerHost } from '../../../../libs/controller-api/index.js';
 import type { ManifestCondition, UmbConditionControllerArguments, UmbExtensionCondition } from '../../../../libs/extension-api/index.js';
 export declare class UmbMenuAliasCondition extends UmbConditionBase<MenuAliasConditionConfig> implements UmbExtensionCondition {

package/dist-cms/packages/core/menu/menu-structure-workspace-context.interface.d.ts

@@ -9,7 +9,6 @@ export interface UmbMenuStructureWorkspaceContext extends UmbContext {
     /**
      * Returns the href for a breadcrumb structure item, or `undefined` if the item should not be a link.
      * Used by the workspace breadcrumb element to generate clickable navigation links.
-     *
      * @param structureItem The structure item to generate an href for.
      * @returns The href string, or `undefined` if the item should not be clickable.
      */

package/dist-cms/packages/core/menu/section-sidebar-menu/global-context/expansion/section-sidebar-menu-app-expansion.manager.d.ts

@@ -5,7 +5,7 @@ import { UmbEntityExpansionManager } from '../../../../utils/index.js';
  * Manages the expansion state of a section sidebar menu.
  * @exports
  * @class UmbSectionSidebarMenuAppExpansionManager
- * @augments {UmbControllerBase}
+ * @augments {UmbEntityExpansionManager}
  */
 export declare class UmbSectionSidebarMenuAppExpansionManager extends UmbEntityExpansionManager<UmbSectionMenuItemExpansionEntryModel> {
     /**

package/dist-cms/packages/core/menu/section-sidebar-menu/global-context/expansion/section-sidebar-menu-app-expansion.manager.js

@@ -3,7 +3,7 @@ import { UmbEntityExpansionManager } from '../../../../utils/index.js';
  * Manages the expansion state of a section sidebar menu.
  * @exports
  * @class UmbSectionSidebarMenuAppExpansionManager
- * @augments {UmbControllerBase}
+ * @augments {UmbEntityExpansionManager}
  */
 export class UmbSectionSidebarMenuAppExpansionManager extends UmbEntityExpansionManager {
     /**

package/dist-cms/packages/core/modal/common/confirm/confirm-modal.controller.d.ts

@@ -2,9 +2,8 @@ import { type UmbConfirmModalData } from './confirm-modal.token.js';
 import type { UmbControllerHost } from '../../../../../libs/controller-api/index.js';
 /**
  *
- * @param host {UmbControllerHost} - The host controller
- * @param args {UmbConfirmModalData} - The data to pass to the modal
- * @param data
+ * @param {UmbControllerHost} host - The host controller
+ * @param {UmbConfirmModalData} data - The data to pass to the modal
  * @returns {UmbOpenModalController} The modal controller instance
  */
 export declare function umbConfirmModal(host: UmbControllerHost, data: UmbConfirmModalData): Promise<undefined>;

package/dist-cms/packages/core/modal/common/confirm/confirm-modal.controller.js

@@ -2,9 +2,8 @@ import { UmbOpenModalController } from '../../controller/open-modal.controller.j
 import { UMB_CONFIRM_MODAL } from './confirm-modal.token.js';
 /**
  *
- * @param host {UmbControllerHost} - The host controller
- * @param args {UmbConfirmModalData} - The data to pass to the modal
- * @param data
+ * @param {UmbControllerHost} host - The host controller
+ * @param {UmbConfirmModalData} data - The data to pass to the modal
  * @returns {UmbOpenModalController} The modal controller instance
  */
 export function umbConfirmModal(host, data) {

package/dist-cms/packages/core/modal/common/info/info-modal.controller.d.ts

@@ -2,8 +2,8 @@ import { type UmbInfoModalData } from './info-modal.token.js';
 import type { UmbControllerHost } from '../../../../../libs/controller-api/index.js';
 /**
  *
- * @param host {UmbControllerHost} - The host controller
- * @param data {UmbInfoModalData} - The data to pass to the modal
+ * @param {UmbControllerHost} host - The host controller
+ * @param {UmbInfoModalData} data - The data to pass to the modal
  * @returns {UmbOpenModalController} The modal controller instance
  */
 export declare function umbInfoModal(host: UmbControllerHost, data: UmbInfoModalData): Promise<undefined>;

package/dist-cms/packages/core/modal/common/info/info-modal.controller.js

@@ -2,8 +2,8 @@ import { UmbOpenModalController } from '../../controller/open-modal.controller.j
 import { UMB_INFO_MODAL } from './info-modal.token.js';
 /**
  *
- * @param host {UmbControllerHost} - The host controller
- * @param data {UmbInfoModalData} - The data to pass to the modal
+ * @param {UmbControllerHost} host - The host controller
+ * @param {UmbInfoModalData} data - The data to pass to the modal
  * @returns {UmbOpenModalController} The modal controller instance
  */
 export function umbInfoModal(host, data) {

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

@@ -5,7 +5,7 @@ export declare class UmbItemPickerModalElement extends UmbModalBaseElement<UmbIt
     #private;
     private _filtered;
     connectedCallback(): void;
-    render(): typeof nothing | import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
     static styles: import("lit").CSSResult[];
 }
 export default UmbItemPickerModalElement;

package/dist-cms/packages/core/modal/component/modal-base.element.d.ts

@@ -20,7 +20,7 @@ export declare abstract class UmbModalBaseElement<ModalDataType extends object =
     protected _submitModal(): void;
     /**
      * Rejects the modal
-     * @param reason
+     * @param {UmbModalRejectReason} [reason] - The reason for rejecting the modal
      * @protected
      * @memberof UmbModalBaseElement
      */

package/dist-cms/packages/core/modal/component/modal-base.element.js

@@ -48,7 +48,7 @@ export class UmbModalBaseElement extends UmbLitElement {
     }
     /**
      * Rejects the modal
-     * @param reason
+     * @param {UmbModalRejectReason} [reason] - The reason for rejecting the modal
      * @protected
      * @memberof UmbModalBaseElement
      */

package/dist-cms/packages/core/modal/context/modal-manager.context.d.ts

@@ -12,10 +12,12 @@ export declare class UmbModalManagerContext extends UmbContextBase {
     /**
      * Opens a modal or sidebar modal
      * @public
+     * @template ModalData
+     * @template ModalValue
      * @param {UmbControllerHost} host - The host that the modal should be attached to, this is usually the controller/element that is opening the modal. This additionally acts as the modal origin for the context api.
      * @param {(string | UmbModalToken)} modalAlias - The alias or token of the modal to open
      * @param {UmbModalContextClassArgs} args - The arguments for this setup.
-     * @returns {*}  {UmbModalHandler}
+     * @returns {UmbModalContext<ModalData, ModalValue>} The opened modal context.
      * @memberof UmbModalManagerContext
      */
     open<ModalData extends {

package/dist-cms/packages/core/modal/context/modal-manager.context.js

@@ -18,10 +18,12 @@ export class UmbModalManagerContext extends UmbContextBase {
     /**
      * Opens a modal or sidebar modal
      * @public
+     * @template ModalData
+     * @template ModalValue
      * @param {UmbControllerHost} host - The host that the modal should be attached to, this is usually the controller/element that is opening the modal. This additionally acts as the modal origin for the context api.
      * @param {(string | UmbModalToken)} modalAlias - The alias or token of the modal to open
      * @param {UmbModalContextClassArgs} args - The arguments for this setup.
-     * @returns {*}  {UmbModalHandler}
+     * @returns {UmbModalContext<ModalData, ModalValue>} The opened modal context.
      * @memberof UmbModalManagerContext
      */
     open(host, modalAlias, args = {}) {