@umbraco-cms/backoffice 17.4.1 → 17.5.0-rc

package/dist-cms/apps/app/app.element.js

@@ -23,6 +23,7 @@ import { UmbAppEntryPointExtensionInitializer, umbExtensionsRegistry, } from '..
 import { redirectToStoredPath } from '../../packages/core/utils/index.js';
 import { umbHttpClient } from '../../packages/core/http-client/index.js';
 import { UmbViewContext } from '../../packages/core/view/index.js';
+import { umbLocalizationRegistry } from '../../packages/core/localization/index.js';
 import './app-logo.element.js';
 import { UMB_CURRENT_USER_CONTEXT } from '../../packages/user/current-user/index.js';
 const CORE_PACKAGES = [
@@ -180,6 +181,15 @@ let UmbAppElement = class UmbAppElement extends UmbLitElement {
     }
     connectedCallback() {
         super.connectedCallback();
+        // The host's `lang` attribute is set by Razor from GlobalSettings.DefaultUILanguage.
+        // Use it as the initial active language; current-user.context overrides it after login.
+        if (this.lang) {
+            umbLocalizationRegistry.loadLanguage(this.lang);
+        }
+        this.observe(umbLocalizationRegistry.currentLanguage, (lang) => {
+            if (lang)
+                this.lang = lang;
+        });
         this.#setup();
     }
     async #setup() {

package/dist-cms/apps/installer/user/installer-user.element.js

@@ -85,6 +85,7 @@ let UmbInstallerUserElement = class UmbInstallerUserElement extends UmbLitElemen
 							name="password"
 							label="password"
 							minlength=${this._minimumPasswordLength}
+							.minlengthMessage=${`Password must be at least ${this._minimumPasswordLength} characters long!`}
 							.value=${this._userFormData?.password ?? ''}
 							required
 							required-message="Password is required"></uui-input-password>

package/dist-cms/assets/lang/da.js

@@ -787,6 +787,7 @@ export default {
         delete: 'Slet',
         deleted: 'Slettet',
         deleting: 'Sletter...',
+        description: 'Beskrivelse',
         design: 'Design',
         details: 'Detaljer',
         dictionary: 'Ordbog',
@@ -1626,6 +1627,7 @@ export default {
         editorSettings: 'Input indstillinger',
         searchResultSettings: 'Tilgængelige indstillinger',
         searchResultEditors: 'Opret ny indstilling',
+        suggestedEditors: 'Forslag',
         configuration: 'Konfiguration',
         yesDelete: 'Ja, slet',
         movedUnderneath: 'blev flyttet til',

package/dist-cms/assets/lang/en.js

@@ -1118,6 +1118,7 @@ export default {
         instruction: 'Sign in to Umbraco',
         signInWith: 'Sign in with {0}',
         timeout: 'Your session has timed out. Please sign in again below.',
+        invalidPasswordMessage: 'The password is not strong enough.',
     },
     main: {
         dashboard: 'Dashboard',
@@ -1345,6 +1346,7 @@ export default {
         showDiff: 'Show differences between the current (draft) version and the selected version.',
         diffHelp: '<del>Red text</del> will be removed in the selected version, <ins>green text</ins> will be added.',
         noDiff: 'There are no differences between the current (draft) version and the selected version.',
+        contentRolledBack: 'Content has been rolled back',
         documentRolledBack: 'Document has been rolled back',
         headline: 'Select a version to compare with the current version',
         htmlHelp: 'This displays the selected version as HTML, if you wish to see the difference between 2 versions at the same time, use the diff view',
@@ -1670,6 +1672,7 @@ export default {
         editorSettings: 'Editor settings',
         searchResultSettings: 'Available configurations',
         searchResultEditors: 'Create a new configuration',
+        suggestedEditors: 'Suggestions',
         configuration: 'Configuration',
         yesDelete: 'Yes, delete',
         movedUnderneath: 'was moved underneath',
@@ -2091,6 +2094,9 @@ export default {
         addUsersToGroupError: 'Could not add users to the group.',
         removeUsersFromGroupError: 'Could not remove users from the group.',
         andMore: 'and %0% more',
+        avatarUploadSuccess: 'Avatar uploaded',
+        avatarDeleteSuccess: 'Avatar deleted',
+        unknownFailure: 'Unknown failure',
         usersNotManagedFromGroup: 'not manageable from this screen.',
     },
     validation: {
@@ -2193,9 +2199,11 @@ export default {
         panelInformation: 'The following URLs redirect to this content item:',
         noRedirects: 'No redirects have been made',
         noRedirectsDescription: 'When a published page gets renamed or moved a redirect will automatically be made to the new page.',
+        noRedirectsForSearch: 'No redirects matching this search criteria',
+        noRedirectsForSearchDescription: 'Double check your search for any error or spelling mistakes.',
         redirectRemoved: 'Redirect URL removed.',
         redirectRemoveError: 'Error removing redirect URL.',
-        redirectRemoveWarning: 'This will remove the redirect',
+        redirectRemoveWarning: 'This will remove the redirect.',
         confirmDisable: 'Are you sure you want to disable the URL tracker?',
         disabledConfirm: 'URL tracker has now been disabled.',
         disableError: 'Error disabling the URL tracker, more information can be found in your log file.',

package/dist-cms/assets/lang/sv.js

@@ -336,6 +336,8 @@ export default {
         nodeNameLinkPicker: 'Länktitel',
         urlLinkPicker: 'Länk',
         anchorInsert: 'Namn',
+        anchorLinkPicker: 'Ankare eller frågesträng',
+        addLink: 'Lägg till länk',
         assignDomain: 'Hantera domännamn',
         closeThisWindow: 'Stäng fönstret',
         confirmdelete: 'Är du säker på att du vill ta bort',
@@ -710,9 +712,11 @@ export default {
         nameentity: 'Namnge %0%...',
         password: 'Fyll i ditt lösenord',
         search: 'Skriv för att söka...',
+        anchor: 'Ange ett ankare eller en frågesträng, #value eller ?key=value',
         username: 'Fyll i ditt lösenord',
         enterAlias: 'Välj alias...',
         enterTags: 'Skriv för att lägga till taggar (och tryck enter efter varje tagg)...',
+        enterUrl: 'Ange en webbadress...',
     },
     publicAccess: {
         paAdvanced: 'Rollbaserat lösenordsskydd',
@@ -1090,4 +1094,17 @@ export default {
         selectAllLogLevelFilters: 'Välj alla',
         deselectAllLogLevelFilters: 'Avmarkera alla',
     },
+    linkPicker: {
+        modalSource: 'Källa',
+        modalManual: 'URL',
+        modalAnchorValidationMessage: 'Ange ett ankare eller en frågesträng, välj ett dokument eller mediaobjekt, eller ange URL manuellt.',
+        modalUrlOrAnchorValidationMessage: 'Ange en URL eller ett ankare.',
+        resetUrlHeadline: 'Återställ URL?',
+        resetUrlMessage: 'Är du säker på att du vill återställa denna URL?',
+        resetUrlLabel: 'Återställ',
+        selectLanguageHint: 'Välj ett språk för länken',
+        selectLanguageDefault: 'Auto (besökarens språk)',
+        configCultureSpecificDocumentLinksLabel: 'Kulturspecifika dokumentlänkar',
+        configCultureSpecificDocumentLinksDescription: 'Aktivera möjligheten att ange en kultur vid länkning till dokument.',
+    },
 };

package/dist-cms/external/dompurify/package.json

@@ -6,6 +6,6 @@
         "build": "vite build"
     },
     "dependencies": {
-        "dompurify": "^3.4.0"
+        "dompurify": "^3.4.1"
     }
 }

package/dist-cms/external/uui/package.json

@@ -6,7 +6,7 @@
         "build": "vite build"
     },
     "dependencies": {
-        "@umbraco-ui/uui": "^1.17.3",
-        "@umbraco-ui/uui-css": "^1.17.3"
+        "@umbraco-ui/uui": "^1.18.0",
+        "@umbraco-ui/uui-css": "^1.18.0"
     }
 }

package/dist-cms/libs/class-api/class.interface.d.ts

@@ -25,17 +25,18 @@ export interface UmbClassInterface extends UmbControllerHost {
      */
     provideContext<R extends UmbContextMinimal = UmbContextMinimal>(alias: string | UmbContextToken<R>, instance: R): UmbContextProviderController<R>;
     /**
-     * @description Setup a subscription for a context. The callback is called when the context is resolved.
+     * @description Subscribe to a context. The callback fires when the context resolves, again if the context is replaced, and can also be invoked with `undefined` if the context is unprovided or the host disconnects. Use this whenever a controller or element needs the context at setup time — both for ongoing observation and for reading values immediately on resolve. This is the default choice; prefer it over `getContext` unless the context is only needed inside a later user action.
      * @param {string} alias
-     * @param {ObserverCallback} callback Callback method called when context is resolved.
+     * @param {UmbContextCallback} callback Callback method called with the resolved context instance or `undefined`.
      * @returns {UmbContextConsumerController} Reference to the created Context Consumer Controller instance
      * @memberof UmbClassInterface
      */
     consumeContext<BaseType extends UmbContextMinimal = UmbContextMinimal, ResultType extends BaseType = BaseType>(alias: string | UmbContextToken<BaseType, ResultType>, callback: UmbContextCallback<ResultType>): UmbContextConsumerController<BaseType, ResultType>;
     /**
-     * @description Retrieve a context. Notice this is a one time retrieving of a context, meaning if you expect this to be up to date with reality you should instead use the consumeContext method.
+     * @description Retrieve a context once as a Promise. Use this only when the context is first needed inside a user action or event handler that runs later (for example a button click, a property action, or an entity action `execute()`). For setup-time access — including a single immediate read — use `consumeContext` instead so the controller lifecycle handles resolution and cleanup. The returned Promise may reject if the context is not found before the default timeout; callers should handle rejection and/or pass `preventTimeout` in the options when waiting longer is expected.
      * @param {string} alias
-     * @returns {Promise<unknown>} A Promise with the reference to the Context Api Instance
+     * @param {UmbClassGetContextOptions} [options] Options for resolving the context once, including timeout-related behavior such as `preventTimeout`.
+     * @returns {Promise<ResultType | undefined>} A Promise resolving to the Context API instance when available, or `undefined` when applicable.
      * @memberof UmbClassInterface
      */
     getContext<BaseType extends UmbContextMinimal = UmbContextMinimal, ResultType extends BaseType = BaseType>(alias: string | UmbContextToken<BaseType, ResultType>, options?: UmbClassGetContextOptions): Promise<ResultType | undefined>;

package/dist-cms/libs/controller-api/controller-host.mixin.d.ts

@@ -1,6 +1,6 @@
 import type { UmbControllerHost } from './controller-host.interface.js';
 import type { ClassConstructor } from '../extension-api/index.js';
-interface UmbControllerHostBaseDeclaration extends Omit<UmbControllerHost, 'getHostElement'> {
+export interface UmbControllerHostBaseDeclaration extends Omit<UmbControllerHost, 'getHostElement'> {
     hostConnected(): void;
     hostDisconnected(): void;
     destroy(): void;
@@ -13,4 +13,3 @@ interface UmbControllerHostBaseDeclaration extends Omit<UmbControllerHost, 'getH
  * @returns {UmbControllerHost} - A class which extends the given superclass.
  */
 export declare const UmbControllerHostMixin: <T extends ClassConstructor>(superClass: T) => ClassConstructor<UmbControllerHostBaseDeclaration> & T;
-export {};

package/dist-cms/libs/controller-api/element-controller-host.d.ts

@@ -0,0 +1,15 @@
+declare const UmbElementControllerHost_base: import("../extension-api/index.js").ClassConstructor<import("./controller-host.mixin.js").UmbControllerHostBaseDeclaration> & {
+    new (): {};
+};
+/**
+ * A controller host backed by a DOM element.
+ * Enables providing contexts and hosting controllers on elements that are not UmbLitElements.
+ * @class UmbElementControllerHost
+ */
+export declare class UmbElementControllerHost extends UmbElementControllerHost_base {
+    #private;
+    constructor(element: Element);
+    getHostElement(): Element;
+    destroy(): void;
+}
+export {};

package/dist-cms/libs/controller-api/element-controller-host.js

@@ -0,0 +1,21 @@
+import { UmbControllerHostMixin } from './controller-host.mixin.js';
+/**
+ * A controller host backed by a DOM element.
+ * Enables providing contexts and hosting controllers on elements that are not UmbLitElements.
+ * @class UmbElementControllerHost
+ */
+export class UmbElementControllerHost extends UmbControllerHostMixin(class {
+}) {
+    #element;
+    constructor(element) {
+        super();
+        this.#element = element;
+    }
+    getHostElement() {
+        return this.#element;
+    }
+    destroy() {
+        super.destroy();
+        this.#element = undefined;
+    }
+}

package/dist-cms/libs/controller-api/index.d.ts

@@ -2,6 +2,7 @@ export * from './controller-host.mixin.js';
 export type * from './controller-host.interface.js';
 export type * from './controller-host-element.interface.js';
 export * from './controller-host-element.mixin.js';
+export * from './element-controller-host.js';
 export type * from './controller.interface.js';
 export type * from './controller-alias.type.js';
 export * from './controller.event.js';

package/dist-cms/libs/controller-api/index.js

@@ -1,3 +1,4 @@
 export * from './controller-host.mixin.js';
 export * from './controller-host-element.mixin.js';
+export * from './element-controller-host.js';
 export * from './controller.event.js';

package/dist-cms/libs/localization-api/localization.manager.d.ts

@@ -14,10 +14,15 @@ export declare class UmbLocalizationManager {
     #private;
     connectedControllers: Set<UmbLocalizationController<UmbLocalizationSetBase>>;
     localizations: Map<string, UmbLocalizationSetBase>;
-    documentDirection: string;
+    /**
+     * The currently active language and direction. Read-only from a consumer perspective —
+     * to change the active language, call `umbLocalizationRegistry.loadLanguage(locale)`.
+     * The fields stay publicly writable for the registry's pipeline; consumers writing here
+     * directly will only sync the field without loading the matching dictionaries.
+     */
+    documentDirection: 'ltr' | 'rtl';
     documentLanguage: string;
     get fallback(): UmbLocalizationSet | undefined;
-    constructor();
     appendConsumer(consumer: UmbLocalizationController<UmbLocalizationSetBase>): void;
     removeConsumer(consumer: UmbLocalizationController<UmbLocalizationSetBase>): void;
     /**
@@ -26,7 +31,5 @@ export declare class UmbLocalizationManager {
      */
     registerLocalization(t: UmbLocalizationSetBase): void;
     registerManyLocalizations(translations: Array<UmbLocalizationSetBase>): void;
-    /** Updates all localized elements that are currently connected */
-    updateAll: () => void;
 }
 export declare const umbLocalizationManager: UmbLocalizationManager;

package/dist-cms/libs/localization-api/localization.manager.js

@@ -1,38 +1,19 @@
 export const UMB_DEFAULT_LOCALIZATION_CULTURE = 'en';
 export class UmbLocalizationManager {
-    #documentElementObserver;
-    #changedKeys;
-    #requestUpdateChangedKeysId;
-    get fallback() {
-        return this.localizations.get(UMB_DEFAULT_LOCALIZATION_CULTURE);
-    }
     constructor() {
         this.connectedControllers = new Set();
         this.#changedKeys = new Set();
         this.#requestUpdateChangedKeysId = undefined;
         this.localizations = new Map();
+        /**
+         * The currently active language and direction. Read-only from a consumer perspective —
+         * to change the active language, call `umbLocalizationRegistry.loadLanguage(locale)`.
+         * The fields stay publicly writable for the registry's pipeline; consumers writing here
+         * directly will only sync the field without loading the matching dictionaries.
+         */
         this.documentDirection = document.documentElement.dir || 'ltr';
         this.documentLanguage = document.documentElement.lang || navigator.language;
         this.#registerLocalizationBind = this.registerLocalization.bind(this);
-        /** Updates all localized elements that are currently connected */
-        this.updateAll = () => {
-            const newDir = document.documentElement.dir || 'ltr';
-            const newLang = document.documentElement.lang || navigator.language;
-            if (this.documentDirection === newDir && this.documentLanguage === newLang)
-                return;
-            // The document direction or language did changed, so lets move on:
-            this.documentDirection = newDir;
-            this.documentLanguage = newLang;
-            // Check if there was any changed.
-            this.connectedControllers.forEach((ctrl) => {
-                ctrl.documentUpdate();
-            });
-            if (this.#requestUpdateChangedKeysId) {
-                cancelAnimationFrame(this.#requestUpdateChangedKeysId);
-                this.#requestUpdateChangedKeysId = undefined;
-            }
-            this.#changedKeys.clear();
-        };
         this.#updateChangedKeys = () => {
             this.#requestUpdateChangedKeysId = undefined;
             this.connectedControllers.forEach((ctrl) => {
@@ -40,11 +21,11 @@ export class UmbLocalizationManager {
             });
             this.#changedKeys.clear();
         };
-        this.#documentElementObserver = new MutationObserver(this.updateAll);
-        this.#documentElementObserver.observe(document.documentElement, {
-            attributes: true,
-            attributeFilter: ['dir', 'lang'],
-        });
+    }
+    #changedKeys;
+    #requestUpdateChangedKeysId;
+    get fallback() {
+        return this.localizations.get(UMB_DEFAULT_LOCALIZATION_CULTURE);
     }
     appendConsumer(consumer) {
         if (this.connectedControllers.has(consumer))

package/dist-cms/libs/observable-api/states/basic-state.d.ts

@@ -1,3 +1,5 @@
+import type { MappingFunction } from '../types/mapping-function.type.js';
+import type { MemoizationFunction } from '../types/memoization-function.type.js';
 import { BehaviorSubject, type Observable } from '../../../external/rxjs/index.js';
 /**
  * @class UmbBasicState
@@ -16,6 +18,14 @@ export declare class UmbBasicState<T> {
      * this.observe(myState, (latestStateValue) => console.log("Value is: ", latestStateValue));
      */
     asObservable(): Observable<T>;
+    /**
+     * @function asObservablePart
+     * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
+     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare if the data has changed. Should return true when data is identical.
+     * @returns {Observable<R>}
+     * @description - Creates an Observable from this State that emits a derived value, deduplicated against its previous emission.
+     */
+    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): Observable<ReturnType>;
     /**
      * @property {unknown} value - the value of the State.
      * @description - Holds the current data of this state.

package/dist-cms/libs/observable-api/states/basic-state.js

@@ -1,4 +1,6 @@
+import { createObservablePart } from '../utils/create-observable-part.function.js';
 import { BehaviorSubject } from '../../../external/rxjs/index.js';
+import { strictEqualityMemoization } from '../utils/strict-equality-memoization.function.js';
 /**
  * @class UmbBasicState
  * @description - State ensures the data is unique, not updating any Observes unless there is an actual change of the value using `===`.
@@ -19,6 +21,16 @@ export class UmbBasicState {
     asObservable() {
         return this._subject.asObservable();
     }
+    /**
+     * @function asObservablePart
+     * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
+     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare if the data has changed. Should return true when data is identical.
+     * @returns {Observable<R>}
+     * @description - Creates an Observable from this State that emits a derived value, deduplicated against its previous emission.
+     */
+    asObservablePart(mappingFunction, memoizationFunction) {
+        return createObservablePart(this._subject, mappingFunction, memoizationFunction ?? strictEqualityMemoization);
+    }
     /**
      * @property {unknown} value - the value of the State.
      * @description - Holds the current data of this state.
@@ -60,7 +72,9 @@ export class UmbBasicState {
      * // myState.value is equal 'Goodnight'.
      */
     setValue(data) {
-        if (this._subject && data !== this._subject.getValue()) {
+        if (!this._subject)
+            throw new Error('_subject is undefined');
+        if (data !== this._subject.getValue()) {
             this._subject.next(data);
         }
     }

package/dist-cms/libs/observable-api/states/class-state.d.ts

@@ -1,3 +1,4 @@
+import type { Observable } from '../../../external/rxjs/index.js';
 import type { MappingFunction } from '../types/mapping-function.type.js';
 import type { MemoizationFunction } from '../types/memoization-function.type.js';
 import type { UmbClassStateData } from '../utils/class-equal-memoization.function.js';
@@ -12,11 +13,11 @@ export declare class UmbClassState<T extends UmbClassStateData | undefined> exte
     /**
      * @function createObservablePart
      * @param {(mappable: UmbClassStateData | undefined) => unknown} mappingFunction - Method to return the part for this Observable to return.
-     * @param {(previousResult: unknown, currentResult: unknown) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+     * @param {(previousResult: unknown, currentResult: unknown) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
      * @returns {Observable<unknown>} - an observable.
      * @description - Creates an Observable from this State.
      */
-    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): import("rxjs").Observable<ReturnType>;
+    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): Observable<ReturnType>;
     /**
      * @function setValue
      * @param {UmbClassStateData | undefined} data - The next data for this state to hold.

package/dist-cms/libs/observable-api/states/class-state.js

@@ -12,7 +12,7 @@ export class UmbClassState extends UmbBasicState {
     /**
      * @function createObservablePart
      * @param {(mappable: UmbClassStateData | undefined) => unknown} mappingFunction - Method to return the part for this Observable to return.
-     * @param {(previousResult: unknown, currentResult: unknown) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+     * @param {(previousResult: unknown, currentResult: unknown) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
      * @returns {Observable<unknown>} - an observable.
      * @description - Creates an Observable from this State.
      */
@@ -26,8 +26,12 @@ export class UmbClassState extends UmbBasicState {
      */
     setValue(data) {
         if (!this._subject)
-            return;
+            throw new Error('_subject is undefined');
         const oldValue = this._subject.getValue();
+        // Do a strict compare first, to avoid reacting on the same instance or going from undefined to undefined.
+        if (data === oldValue)
+            return;
+        // Then if the current value has an equal method, use it to compare with the incoming value.
         if (data && oldValue?.equal(data))
             return;
         this._subject.next(data);

package/dist-cms/libs/observable-api/states/deep-state.d.ts

@@ -1,6 +1,7 @@
 import type { MappingFunction } from '../types/mapping-function.type.js';
 import type { MemoizationFunction } from '../types/memoization-function.type.js';
 import { UmbBasicState } from './basic-state.js';
+import type { Observable } from '../../../external/rxjs/index.js';
 /**
  * @class UmbDeepState
  * @augments {BehaviorSubject<T>}
@@ -13,11 +14,11 @@ export declare class UmbDeepState<T> extends UmbBasicState<T> {
     /**
      * @function createObservablePart
      * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
-     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
      * @returns {Observable<R>}
      * @description - Creates an Observable from this State.
      */
-    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): import("rxjs").Observable<ReturnType>;
+    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): Observable<ReturnType>;
     /**
      * @function setValue
      * @param {T} data - The next data for this state to hold.
@@ -40,11 +41,12 @@ export declare class UmbDeepState<T> extends UmbBasicState<T> {
      * @description - Check if the state is muted.
      * @returns {boolean} - Returns true if the state is muted.
      */
-    isMuted(): boolean | undefined;
+    isMuted(): boolean;
     /**
      * @function getMutePromise
      * @description - Get a promise which resolves when the mute is unset.
-     * @returns {Promise<void>}
+     * @returns {Promise<boolean>} - Returns a promise which resolves to true if the state was muted and is now unmuted, or false if the state was not muted.
      */
-    getMutePromise(): Promise<void>;
+    getMutePromise(): Promise<boolean>;
+    destroy(): void;
 }

package/dist-cms/libs/observable-api/states/deep-state.js

@@ -11,6 +11,7 @@ import { UmbBasicState } from './basic-state.js';
 export class UmbDeepState extends UmbBasicState {
     #mute;
     #value;
+    #muteResolvers;
     constructor(initialData) {
         super(deepFreeze(initialData));
         this.#value = this._subject.getValue();
@@ -18,7 +19,7 @@ export class UmbDeepState extends UmbBasicState {
     /**
      * @function createObservablePart
      * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
-     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+     * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
      * @returns {Observable<R>}
      * @description - Creates an Observable from this State.
      */
@@ -32,7 +33,7 @@ export class UmbDeepState extends UmbBasicState {
      */
     setValue(data) {
         if (!this._subject)
-            return;
+            throw new Error('_subject is undefined');
         const frozenData = deepFreeze(data);
         this.#value = frozenData;
         // Only update data if its not muted and is different than current data. [NL]
@@ -61,8 +62,16 @@ export class UmbDeepState extends UmbBasicState {
             return;
         this.#mute = false;
         // Only update data if it is different than current data. [NL]
+        if (!this._subject)
+            throw new Error('_subject is undefined');
         if (!jsonStringComparison(this.#value, this._subject.getValue())) {
-            this._subject?.next(this.#value);
+            this._subject.next(this.#value);
+        }
+        // Resolve any pending mute promises — independent of whether an emission occurred. [NL]
+        if ((this.#muteResolvers?.length ?? 0) > 0) {
+            const resolvers = this.#muteResolvers;
+            this.#muteResolvers = [];
+            resolvers.forEach((resolve) => resolve(true));
         }
     }
     /**
@@ -71,23 +80,28 @@ export class UmbDeepState extends UmbBasicState {
      * @returns {boolean} - Returns true if the state is muted.
      */
     isMuted() {
-        return this.#mute;
+        return this.#mute ?? false;
     }
     /**
      * @function getMutePromise
      * @description - Get a promise which resolves when the mute is unset.
-     * @returns {Promise<void>}
+     * @returns {Promise<boolean>} - Returns a promise which resolves to true if the state was muted and is now unmuted, or false if the state was not muted.
      */
     getMutePromise() {
+        if (!this.#mute) {
+            return Promise.resolve(false);
+        }
         return new Promise((resolve) => {
-            if (!this.#mute) {
-                resolve();
-                return;
-            }
-            const subscription = this._subject.subscribe(() => {
-                subscription.unsubscribe();
-                resolve();
-            });
+            (this.#muteResolvers ??= []).push(resolve);
         });
     }
+    destroy() {
+        // Drain any pending mute promises so awaiters don't hang. [NL]
+        if ((this.#muteResolvers?.length ?? 0) > 0) {
+            const resolvers = this.#muteResolvers;
+            this.#muteResolvers = [];
+            resolvers.forEach((resolve) => resolve(false));
+        }
+        super.destroy();
+    }
 }

package/dist-cms/libs/observable-api/states/string-state.d.ts

@@ -1,4 +1,3 @@
-import type { MappingFunction, MemoizationFunction } from '../types/index.js';
 import { UmbBasicState } from './basic-state.js';
 /**
  * @class UmbStringState
@@ -7,5 +6,4 @@ import { UmbBasicState } from './basic-state.js';
  */
 export declare class UmbStringState<T> extends UmbBasicState<T | string> {
     constructor(initialData: T | string);
-    asObservablePart<ReturnType>(mappingFunction: MappingFunction<T | string, ReturnType>, memoizationFunction?: MemoizationFunction<ReturnType>): import("rxjs").Observable<ReturnType>;
 }

package/dist-cms/libs/observable-api/states/string-state.js

@@ -1,4 +1,3 @@
-import { createObservablePart, strictEqualityMemoization } from '../utils/index.js';
 import { UmbBasicState } from './basic-state.js';
 /**
  * @class UmbStringState
@@ -9,7 +8,4 @@ export class UmbStringState extends UmbBasicState {
     constructor(initialData) {
         super(initialData);
     }
-    asObservablePart(mappingFunction, memoizationFunction) {
-        return createObservablePart(this._subject, mappingFunction, memoizationFunction ?? strictEqualityMemoization);
-    }
 }

package/dist-cms/libs/observable-api/utils/create-observable-part.function.d.ts

@@ -5,7 +5,7 @@ import type { Observable } from '../../../external/rxjs/index.js';
  * @function createObservablePart
  * @param {Observable<T>} source - RxJS Subject to use for this Observable.
  * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
- * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+ * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
  * @returns {Observable<T>}
  * @description - Creates a RxJS Observable from RxJS Subject.
  * @example <caption>Example create a Observable for part of the data Subject.</caption>

package/dist-cms/libs/observable-api/utils/create-observable-part.function.js

@@ -4,7 +4,7 @@ import { distinctUntilChanged, map, shareReplay } from '../../../external/rxjs/i
  * @function createObservablePart
  * @param {Observable<T>} source - RxJS Subject to use for this Observable.
  * @param {(mappable: T) => R} mappingFunction - Method to return the part for this Observable to return.
- * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to Compare if the data has changed. Should return true when data is different.
+ * @param {(previousResult: R, currentResult: R) => boolean} [memoizationFunction] - Method to compare two results. Should return true when data is the same (unchanged), preventing unnecessary emissions.
  * @returns {Observable<T>}
  * @description - Creates a RxJS Observable from RxJS Subject.
  * @example <caption>Example create a Observable for part of the data Subject.</caption>

package/dist-cms/packages/block/block/action/block-action-base.d.ts

@@ -0,0 +1,13 @@
+import type { UmbBlockActionArgs } from './types.js';
+import type { UmbBlockAction } from './block-action.interface.js';
+import { UmbActionBase } from '../../../core/action/index.js';
+/**
+ * Base class for block action API implementations.
+ * Provides default no-op implementations of getHref(), execute(), and getValidationDataPath().
+ * Subclasses override only the methods they need.
+ */
+export declare abstract class UmbBlockActionBase<ArgsMetaType> extends UmbActionBase<UmbBlockActionArgs<ArgsMetaType>> implements UmbBlockAction<ArgsMetaType> {
+    getHref(): Promise<string | undefined>;
+    execute(): Promise<void>;
+    getValidationDataPath(): Promise<string | undefined>;
+}