@umbraco-cms/backoffice 18.0.2 → 18.1.0-rc

package/dist-cms/packages/core/menu/section-sidebar-menu-with-entity-actions/section-sidebar-menu-with-entity-actions.element.js

@@ -5,19 +5,20 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { UmbSectionSidebarMenuElement } from '../section-sidebar-menu/section-sidebar-menu.element.js';
-import { css, html, customElement, state } from '../../../../external/lit/index.js';
-import { UmbParentEntityContext } from '../../entity/index.js';
+import { css, html, customElement } from '../../../../external/lit/index.js';
+import { UmbEntityContext, UmbParentEntityContext } from '../../entity/index.js';
 let UmbSectionSidebarMenuWithEntityActionsElement = class UmbSectionSidebarMenuWithEntityActionsElement extends UmbSectionSidebarMenuElement {
+    #entityContext = new UmbEntityContext(this);
+    #parentContext = new UmbParentEntityContext(this);
     constructor() {
-        super(...arguments);
-        this._unique = null;
-        this.#parentContext = new UmbParentEntityContext(this);
+        super();
+        this.#entityContext.setUnique(null);
     }
-    #parentContext;
     updated(_changedProperties) {
         if (_changedProperties.has('manifest')) {
             const entityType = this.manifest?.meta.entityType;
-            this.#parentContext.setParent(entityType ? { unique: this._unique, entityType } : undefined);
+            this.#entityContext.setEntityType(entityType);
+            this.#parentContext.setParent(entityType ? { unique: null, entityType } : undefined);
         }
     }
     renderHeader() {
@@ -25,12 +26,7 @@ let UmbSectionSidebarMenuWithEntityActionsElement = class UmbSectionSidebarMenuW
         return html `
 			<div id="header">
 				<h3>${label}</h3>
-				<umb-entity-actions-bundle
-					slot="actions"
-					.unique=${this._unique}
-					.entityType=${this.manifest?.meta.entityType}
-					.label=${label}>
-				</umb-entity-actions-bundle>
+				<umb-entity-actions-bundle slot="actions" .label=${label}></umb-entity-actions-bundle>
 			</div>
 		`;
     }
@@ -48,12 +44,6 @@ let UmbSectionSidebarMenuWithEntityActionsElement = class UmbSectionSidebarMenuW
 		`,
     ]; }
 };
-__decorate([
-    state()
-], UmbSectionSidebarMenuWithEntityActionsElement.prototype, "_unique", void 0);
-__decorate([
-    state()
-], UmbSectionSidebarMenuWithEntityActionsElement.prototype, "_entityType", void 0);
 UmbSectionSidebarMenuWithEntityActionsElement = __decorate([
     customElement('umb-section-sidebar-menu-with-entity-actions')
 ], UmbSectionSidebarMenuWithEntityActionsElement);

package/dist-cms/packages/core/notification/controllers/peek-error/peek-error-notification.element.js

@@ -4,7 +4,8 @@ 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 { css, customElement, html, ifDefined, nothing, property } from '../../../../../external/lit/index.js';
+import { css, customElement, html, ifDefined, nothing, property, unsafeHTML, } from '../../../../../external/lit/index.js';
+import { sanitizeHTML } from '../../../utils/index.js';
 import { UmbLitElement } from '../../../lit-element/index.js';
 import { UMB_ERROR_VIEWER_MODAL, UMB_MODAL_MANAGER_CONTEXT, } from '../../../modal/index.js';
 const DETAIL_MAX_LENGTH = 250;
@@ -18,11 +19,19 @@ let UmbPeekErrorNotificationElement = class UmbPeekErrorNotificationElement exte
         this.notificationHandler.close();
     }
     get #message() {
+        const message = this.#renderMessage();
         const detail = this.data?.detail;
         if (detail && detail.length <= DETAIL_MAX_LENGTH) {
-            return html `${this.data?.message}
+            return html `${message}
 				<p class="detail">${detail}</p>`;
         }
+        return message;
+    }
+    #renderMessage() {
+        const htmlMessage = this.data?.htmlMessage;
+        if (htmlMessage) {
+            return typeof htmlMessage === 'string' ? unsafeHTML(sanitizeHTML(htmlMessage)) : htmlMessage;
+        }
         return this.data?.message;
     }
     get #validationErrors() {

package/dist-cms/packages/core/notification/layouts/default/notification-layout-default.element.js

@@ -4,17 +4,25 @@ 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 { html, LitElement, customElement, property, ifDefined, nothing, css, } from '../../../../../external/lit/index.js';
+import { html, LitElement, customElement, property, ifDefined, nothing, css, unsafeHTML, } from '../../../../../external/lit/index.js';
+import { sanitizeHTML } from '../../../utils/index.js';
 import { UmbTextStyles } from '../../../style/index.js';
 let UmbNotificationLayoutDefaultElement = class UmbNotificationLayoutDefaultElement extends LitElement {
     render() {
         return html `
 			<uui-toast-notification-layout id="layout" headline="${ifDefined(this.data.headline)}" class="uui-text">
-				<div id="message">${this.data.message}</div>
+				<div id="message">${this.#renderMessage()}</div>
 				${this.#renderStructuredList(this.data.structuredList)}
 			</uui-toast-notification-layout>
 		`;
     }
+    #renderMessage() {
+        const htmlMessage = this.data.htmlMessage;
+        if (htmlMessage) {
+            return typeof htmlMessage === 'string' ? unsafeHTML(sanitizeHTML(htmlMessage)) : htmlMessage;
+        }
+        return this.data.message;
+    }
     #renderStructuredList(list) {
         if (!this.data.structuredList)
             return nothing;

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

@@ -1,9 +1,24 @@
+import type { TemplateResult } from '../../../external/lit/index.js';
 /**
  * The default data of notifications
  * @interface UmbNotificationDefaultData
  */
 export interface UmbNotificationDefaultData {
+    /**
+     * The notification message, rendered as plain text. Use {@link UmbNotificationDefaultData.htmlMessage} to render HTML.
+     */
     message: string;
+    /**
+     * A message rendered as HTML. Takes precedence over `message` when set.
+     *
+     * A string value is sanitized before rendering, so scripts and event handlers are stripped.
+     * A TemplateResult is rendered as-is — Lit escapes its bindings, so it is safe by construction
+     * unless you explicitly opt out with `unsafeHTML`.
+     *
+     * Do not interpolate user-controlled content into an HTML string: sanitization prevents script
+     * execution but not markup injection (e.g. links or images).
+     */
+    htmlMessage?: string | TemplateResult;
     headline?: string;
     /**
      * @deprecated Use {@link UmbPeekErrorArgs} instead. Scheduled for removal in Umbraco 19.

package/dist-cms/packages/core/property/components/property/property.context.js

@@ -116,15 +116,22 @@ export class UmbPropertyContext extends UmbContextBase {
     }
     async _observeProperty() {
         const alias = this.#alias.getValue();
+        // Don't fall through to observing an `undefined` source: that blanks the value and tears down the live value
+        // subscription, so a transient absence of the dataset context or alias would wipe an already-filled value.
         if (!this.#datasetContext || !alias)
             return;
-        this.observe(await this.#datasetContext.propertyVariantId?.(alias), (variantId) => {
+        const variantIdSource = await this.#datasetContext.propertyVariantId?.(alias);
+        const valueSource = await this.#datasetContext.propertyValueByAlias(alias);
+        // Guard: this context may have been destroyed while the awaits were in flight.
+        if (!this._host)
+            return;
+        this.observe(variantIdSource, (variantId) => {
             this.#variantId.setValue(variantId);
         }, 'observeVariantId');
-        this.observe(await this.#datasetContext.propertyValueByAlias(alias), (value) => {
+        this.observe(valueSource, (value) => {
             this.#value.setValue(value);
         }, 'observeValue');
-        this.observe(this.#datasetContext.readOnly, (value) => {
+        this.observe(this.#datasetContext?.readOnly, (value) => {
             const unique = 'UMB_DATASET';
             if (value) {
                 this.readOnlyState.addState({

package/dist-cms/packages/core/property/components/property/property.element.js

@@ -186,6 +186,9 @@ let UmbPropertyElement = class UmbPropertyElement extends UmbLitElement {
         };
         this.observe(this.#propertyContext.alias, (alias) => {
             this._alias = alias;
+            if (this._element) {
+                this._element.alias = alias;
+            }
             this.#pathAddendum.setAddendum(alias);
         }, null);
         this.observe(this.#propertyContext.label, (label) => {
@@ -262,6 +265,7 @@ let UmbPropertyElement = class UmbPropertyElement extends UmbLitElement {
                 // No need to observe mandatory or label, as we already do so and set it on the _element if present: [NL]
                 this._element.manifest = manifest;
                 this._element.mandatory = this._mandatory;
+                this._element.alias = this._alias;
                 this._element.name = this._label;
                 this._element.dataSourceAlias = this.#propertyContext.getEditorDataSourceAlias();
                 // No need for a controller alias, as the clean is handled via the observer prop:

package/dist-cms/packages/core/property/components/property-layout/property-layout.element.d.ts

@@ -11,33 +11,33 @@ export declare class UmbPropertyLayoutElement extends UmbLitElement {
     #private;
     /**
      * Alias. The technical name of the property.
-     * @type {string}
+     * @type {string | undefined}
      * @attr
-     * @default ''
+     * @default undefined
      */
-    alias: string;
+    alias?: string;
     /**
      * Label. Name of the property.
-     * @type {string}
+     * @type {string | undefined}
      * @attr
-     * @default ''
+     * @default undefined
      */
-    label: string;
+    label?: string;
     /**
      * Orientation: Horizontal is the default where label goes left and editor right.
      * Vertical is where label goes above the editor.
      * @enum ['horizontal', 'vertical']
      * @attr
-     * @default ''
+     * @default 'horizontal'
      */
     orientation: 'horizontal' | 'vertical';
     /**
      * Description: render a description underneath the label.
-     * @type {string}
+     * @type {string | undefined}
      * @attr
-     * @default ''
+     * @default undefined
      */
-    description: string;
+    description?: string;
     /**
      * @description Make the property appear invalid.
      * @type {boolean}

package/dist-cms/packages/core/property/components/property-layout/property-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 { css, customElement, html, property, when } from '../../../../../external/lit/index.js';
+import { css, customElement, html, ifDefined, property, when } from '../../../../../external/lit/index.js';
 import { UmbLitElement } from '../../../lit-element/index.js';
 import { UmbTextStyles } from '../../../style/index.js';
 import '../../../../ufm/index.js';
@@ -18,41 +18,20 @@ import '../../../../ufm/index.js';
 let UmbPropertyLayoutElement = class UmbPropertyLayoutElement extends UmbLitElement {
     constructor() {
         super(...arguments);
-        /**
-         * Alias. The technical name of the property.
-         * @type {string}
-         * @attr
-         * @default ''
-         */
-        this.alias = '';
-        /**
-         * Label. Name of the property.
-         * @type {string}
-         * @attr
-         * @default ''
-         */
-        this.label = '';
         /**
          * Orientation: Horizontal is the default where label goes left and editor right.
          * Vertical is where label goes above the editor.
          * @enum ['horizontal', 'vertical']
          * @attr
-         * @default ''
+         * @default 'horizontal'
          */
         this.orientation = 'horizontal';
-        /**
-         * Description: render a description underneath the label.
-         * @type {string}
-         * @attr
-         * @default ''
-         */
-        this.description = '';
     }
     render() {
         // TODO: Only show alias on label if user has access to DocumentType within settings:
         return html `
 			<div id="headerColumn">
-				<uui-label id="label" title=${this.alias} ?required=${this.mandatory}>
+				<uui-label id="label" title=${ifDefined(this.alias)} ?required=${this.mandatory}>
 					${this.localize.string(this.label)}
 					${when(this.invalid, () => html `<div id="invalid-badge"><uui-badge color="invalid" attention>!</uui-badge></div>`)}
 				</uui-label>

package/dist-cms/packages/core/property/manifests.d.ts

@@ -1 +1 @@
-export declare const manifests: (import("../../tiptap/index.js").ManifestTiptapToolbarExtensionButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../modal/types.js").ManifestModal | import("../tree/types.js").ManifestTreeItem | import("../collection/types.js").ManifestCollection | import("../collection/types.js").ManifestCollectionMenu | import("../collection/menu/menu-item/extension/collection-menu-item.extension.js").ManifestCollectionMenuItem | import("../tree/types.js").ManifestTree | import("../collection/types.js").ManifestCollectionView | import("../collection/types.js").ManifestCollectionViewTableKind | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionActionButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionColorPickerButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../entity-item/entity-item-ref/entity-item-ref.extension.js").ManifestEntityItemRef<import("../entity-item/entity-item-ref/entity-item-ref.extension.js").MetaEntityItemRef> | import("../extension-registry/index.js").ManifestAppEntryPoint | import("../extension-registry/index.js").ManifestBackofficeEntryPoint | import("../extension-registry/index.js").ManifestEntryPoint | (import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | /*elided*/ any>>>>>>>>>>>) | import("../repository/types.js").ManifestDataSourceDataMapping<import("../repository/types.js").MetaDataSourceDataMapping> | import("../../ufm/index.js").ManifestUfmFilter | import("../../ufm/index.js").ManifestUfmComponent | import("../../ufm/index.js").ManifestMarkedExtension | import("./types.js").ManifestPropertyContext<import("./types.js").MetaPropertyContext> | import("./types.js").ManifestPropertyValueCloner | (import("../property-editor/types.js").ManifestPropertyEditorSchema | import("../property-editor/types.js").ManifestPropertyEditorUi) | import("./types.js").ManifestPropertyValuePreset | import("./types.js").ManifestPropertyValueResolver | import("../tree/types.js").ManifestEntityActionDuplicateToKind | import("../tree/types.js").ManifestEntityActionMoveToKind | import("../tree/types.js").ManifestEntityActionReloadTreeItemChildrenKind | import("../tree/types.js").ManifestEntityActionSortChildrenOfKind | import("../section/types.js").ManifestSectionContext<import("../section/types.js").MetaSectionContext> | (import("../section/types.js").ManifestSectionSidebarApp | import("../section/types.js").ManifestSection | import("../section/types.js").ManifestSectionRoute | import("../section/types.js").ManifestSectionView) | import("../dashboard/dashboard.extension.js").ManifestDashboard | import("../workspace/types.js").ManifestWorkspaceActionMenuItem<import("../workspace/types.js").MetaWorkspaceActionMenuItem> | import("../workspace/types.js").ManifestWorkspaceActionMenuItemDefaultKind<import("../workspace/types.js").MetaWorkspaceActionMenuItemDefaultKind> | import("../workspace/types.js").ManifestWorkspaceInfoApp<import("../workspace/types.js").MetaWorkspaceInfoApp> | import("../workspace/types.js").ManifestWorkspaceDefaultKind | import("../workspace/types.js").ManifestWorkspaceAction<import("../workspace/types.js").MetaWorkspaceAction, import("../workspace/types.js").UmbWorkspaceAction<import("../workspace/types.js").MetaWorkspaceAction>> | import("../workspace/types.js").ManifestWorkspaceActionDefaultKind | import("../workspace/types.js").ManifestWorkspaceFooterApp | import("../workspace/types.js").ManifestWorkspaceFooterAppMenuBreadcrumbKind | import("../workspace/types.js").ManifestWorkspaceFooterAppVariantMenuBreadcrumbKind | import("../workspace/types.js").ManifestWorkspaceView<import("../workspace/types.js").MetaWorkspaceView> | import("../workspace/types.js").ManifestWorkspaceViewContentTypeDesignEditorKind | import("../workspace/types.js").ManifestWorkspace<import("../workspace/types.js").MetaWorkspace, import("../../../libs/controller-api/index.js").UmbControllerHostElement, import("../workspace/workspace-context.interface.js").UmbWorkspaceContext> | import("../workspace/types.js").ManifestWorkspaceRoutableKind | import("../workspace/types.js").ManifestWorkspaceContext | import("../tree/types.js").ManifestEntityActionCreateFolderKind | import("../tree/types.js").ManifestEntityActionDeleteFolderKind | import("../tree/types.js").ManifestEntityActionUpdateFolderKind | import("../entity-create-option-action/entity-create-option-action.extension.js").ManifestEntityCreateOptionAction<import("../entity-create-option-action/entity-create-option-action.extension.js").MetaEntityCreateOptionAction> | import("../tree/types.js").ManifestEntityCreateOptionActionFolderKind | import("../menu/menu.extension.js").ManifestMenu | import("../menu/types.js").ManifestMenuItem | import("../menu/types.js").ManifestMenuItemActionKind | import("../menu/types.js").ManifestMenuItemLinkKind | import("../menu/types.js").ManifestWorkspaceContextMenuStructureKind | import("../tree/types.js").ManifestMenuItemTreeKind | import("../collection/types.js").ManifestEntityCollectionItemCard<import("../collection/types.js").MetaEntityCollectionItemCard> | import("../collection/types.js").ManifestEntityCollectionItemRef<import("../collection/types.js").MetaEntityCollectionItemRef> | import("../collection/types.js").ManifestCollectionAction | import("../collection/types.js").ManifestCollectionActionCreateKind | import("../collection/types.js").ManifestCollectionTextFilter | import("../collection/types.js").ManifestWorkspaceViewCollectionKind | import("../value-summary/index.js").ManifestValueSummary | import("../../content/content/index.js").ManifestAuditLogAction<import("../../content/content/index.js").MetaAuditLogAction> | import("../../content/content/index.js").ManifestAuditLogActionDefaultKind | import("../../content/content/index.js").ManifestEntityActionContentRollbackKind | import("../../content/content/index.js").ManifestWorkspaceInfoAppAuditLogKind | import("../../content/content/index.js").ManifestWorkspaceViewContentCollectionKind | import("../../content/content/index.js").ManifestEntityActionSortChildrenOfContentKind | import("../../user/current-user/index.js").ManifestUserProfileApp | import("../../user/current-user/index.js").ManifestCurrentUserAction<import("../../user/current-user/index.js").MetaCurrentUserAction> | import("../icon-registry/types.js").ManifestIcons | import("../../user/user-permission/index.js").ManifestEntityUserPermission | import("../../user/user-permission/index.js").ManifestGranularUserPermission | import("../localization/index.js").ManifestLocalization | import("../picker/types.js").ManifestPickerSearchResultItem | import("../property-editor-data-source/types.js").ManifestPropertyEditorDataSource | import("../validation/types.js").ManifestPropertyValidationPathTranslator<any> | import("../entity-action/types.js").ManifestEntityActionDeleteKind | import("../entity-action/entity-action.extension.js").ManifestEntityAction<import("../entity-action/entity-action.extension.js").MetaEntityAction> | import("../entity-action/types.js").ManifestEntityActionDefaultKind | import("../entity-action/common/create/types.js").ManifestEntityActionCreateKind | import("../entity-bulk-action/types.js").ManifestEntityBulkActionDeleteKind | import("../extension-registry/index.js").UmbEntityBulkActionExtensions | import("../extension-registry/index.js").ManifestExternalLoginProvider | import("../extension-registry/index.js").ManifestGlobalContext | import("../extension-registry/index.js").ManifestHeaderApp | import("../extension-registry/index.js").ManifestHeaderAppButtonKind | import("../extension-registry/index.js").ManifestMfaLoginProvider | import("../extension-registry/index.js").ManifestPreviewAppProvider | import("../extension-registry/index.js").ManifestRepository<import("../../../libs/extension-api/index.js").UmbApi> | import("../extension-registry/index.js").UmbStoreExtensions | import("../search/types.js").ManifestSearchProvider | import("../search/types.js").ManifestSearchResultItem | import("../search/types.js").ManifestGlobalSearch | import("../auth/auth-provider.extension.js").ManifestAuthProvider | import("../themes/theme.extension.js").ManifestTheme | import("../entity-sign/types.js").ManifestEntitySign<import("../entity-sign/types.js").MetaEntitySign> | import("../entity-sign/kinds/types.js").ManifestEntitySignIconKind | import("../property-action/property-action.extension.js").UmbPropertyActionExtensions | import("../property-sort-mode/types.js").ManifestPropertyActionSortModeKind<import("../property-action/property-action.extension.js").MetaPropertyActionDefaultKind> | import("../recycle-bin/types.js").ManifestCollectionActionEmptyRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityActionTrashKind | import("../recycle-bin/types.js").ManifestEntityActionTrashFolderKind | import("../recycle-bin/types.js").ManifestEntityActionRestoreFromRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityActionEmptyRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityBulkActionTrashKind | import("../recycle-bin/types.js").ManifestTreeItemRecycleBinKind | import("../server-file-system/types.js").ManifestEntityActionRenameServerFileKind | import("../property-sort-mode/types.js").ManifestPropertyContextSortModeKind | import("../../block/block/index.js").ManifestBlockAction<import("../../block/block/index.js").MetaBlockAction> | import("../../block/block/index.js").ManifestBlockActionDefaultKind | import("../../block/block-custom-view/index.js").ManifestBlockEditorCustomView | import("../../clipboard/index.js").ManifestClipboardCopyPropertyValueTranslator | import("../../clipboard/index.js").ManifestClipboardPastePropertyValueTranslator | import("../../clipboard/index.js").ManifestPropertyActionPasteFromClipboardKind | import("../../clipboard/index.js").ManifestPropertyActionCopyToClipboardKind | import("../../relations/relations/index.js").ManifestEntityBulkActionDeleteWithRelationKind | import("../../relations/relations/index.js").ManifestEntityBulkActionTrashWithRelationKind | import("../../relations/relations/index.js").ManifestEntityActionDeleteWithRelationKind | import("../../relations/relations/index.js").ManifestEntityActionTrashWithRelationKind | import("../../documents/documents/index.js").ManifestWorkspaceActionMenuItemPreviewOptionKind | import("../../media/media/index.js").ManifestFileUploadPreview | import("../../health-check/index.js").ManifestHealthCheck | import("../../packages/package/index.js").ManifestPackageView | import("../../property-editors/content-picker/index.js").ManifestDynamicRootOrigin | import("../../property-editors/content-picker/index.js").ManifestDynamicRootQueryStep | import("../../relations/relations/reference/workspace-info-app/types.js").ManifestWorkspaceInfoAppEntityReferencesKind | import("../../tiptap/index.js").ManifestTiptapExtension<import("../../tiptap/index.js").MetaTiptapExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtension<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionMenuKind | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionStyleMenuKind | import("../../tiptap/index.js").ManifestTiptapStatusbarExtension<import("../../tiptap/index.js").MetaTiptapStatusbarExtension> | import("../../clipboard/property/context/types.js").ManifestPropertyContextClipboardKind | import("../section/default/types.js").ManifestSectionDefaultKind | import("../../markdown-editor/index.js").ManifestMonacoMarkdownEditorAction)[];
+export declare const manifests: (import("../../tiptap/index.js").ManifestTiptapToolbarExtensionButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../modal/types.js").ManifestModal | import("../tree/types.js").ManifestTreeItem | import("../collection/types.js").ManifestCollection | import("../collection/types.js").ManifestCollectionMenu | import("../collection/menu/menu-item/extension/collection-menu-item.extension.js").ManifestCollectionMenuItem | import("../tree/types.js").ManifestTree | import("../collection/types.js").ManifestCollectionView | import("../collection/types.js").ManifestCollectionViewTableKind | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionActionButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionColorPickerButtonKind<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../entity-item/entity-item-ref/entity-item-ref.extension.js").ManifestEntityItemRef<import("../entity-item/entity-item-ref/entity-item-ref.extension.js").MetaEntityItemRef> | import("../extension-registry/index.js").ManifestAppEntryPoint | import("../extension-registry/index.js").ManifestBackofficeEntryPoint | import("../extension-registry/index.js").ManifestEntryPoint | (import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | import("../../../libs/extension-api/index.js").ManifestBundle<import("../../../libs/extension-api/index.js").ManifestBase | import("../../../libs/extension-api/index.js").ManifestCondition | /*elided*/ any>>>>>>>>>>>) | import("../repository/types.js").ManifestDataSourceDataMapping<import("../repository/types.js").MetaDataSourceDataMapping> | import("../../ufm/index.js").ManifestUfmFilter | import("../../ufm/index.js").ManifestUfmComponent | import("../../ufm/index.js").ManifestMarkedExtension | import("./types.js").ManifestPropertyContext<import("./types.js").MetaPropertyContext> | import("./types.js").ManifestPropertyValueCloner | (import("../property-editor/types.js").ManifestPropertyEditorSchema | import("../property-editor/types.js").ManifestPropertyEditorUi) | import("./types.js").ManifestPropertyValuePreset | import("./types.js").ManifestPropertyValueResolver | import("../tree/index.js").ManifestTreeAction | import("../entity-create-option-action/entity-create-option-action.extension.js").ManifestEntityCreateOptionAction<import("../entity-create-option-action/entity-create-option-action.extension.js").MetaEntityCreateOptionAction> | import("../tree/index.js").ManifestTreeActionCreateKind | import("../tree/types.js").ManifestEntityActionDuplicateToKind | import("../tree/types.js").ManifestEntityActionMoveToKind | import("../tree/types.js").ManifestEntityActionReloadTreeItemChildrenKind | import("../tree/types.js").ManifestEntityActionSortChildrenOfKind | import("../workspace/types.js").ManifestWorkspaceActionMenuItem<import("../workspace/types.js").MetaWorkspaceActionMenuItem> | import("../workspace/types.js").ManifestWorkspaceActionMenuItemDefaultKind<import("../workspace/types.js").MetaWorkspaceActionMenuItemDefaultKind> | import("../workspace/types.js").ManifestWorkspaceInfoApp<import("../workspace/types.js").MetaWorkspaceInfoApp> | import("../workspace/types.js").ManifestWorkspaceDefaultKind | import("../workspace/types.js").ManifestWorkspaceAction<import("../workspace/types.js").MetaWorkspaceAction, import("../workspace/types.js").UmbWorkspaceAction<import("../workspace/types.js").MetaWorkspaceAction>> | import("../workspace/types.js").ManifestWorkspaceActionDefaultKind | import("../workspace/types.js").ManifestWorkspaceFooterApp | import("../workspace/types.js").ManifestWorkspaceFooterAppMenuBreadcrumbKind | import("../workspace/types.js").ManifestWorkspaceFooterAppVariantMenuBreadcrumbKind | import("../workspace/types.js").ManifestWorkspaceView<import("../workspace/types.js").MetaWorkspaceView> | import("../workspace/types.js").ManifestWorkspaceViewContentTypeDesignEditorKind | import("../workspace/types.js").ManifestWorkspace<import("../workspace/types.js").MetaWorkspace, import("../../../libs/controller-api/index.js").UmbControllerHostElement, import("../workspace/workspace-context.interface.js").UmbWorkspaceContext> | import("../workspace/types.js").ManifestWorkspaceRoutableKind | import("../workspace/types.js").ManifestWorkspaceContext | import("../section/types.js").ManifestSectionContext<import("../section/types.js").MetaSectionContext> | (import("../section/types.js").ManifestSectionSidebarApp | import("../section/types.js").ManifestSection | import("../section/types.js").ManifestSectionRoute | import("../section/types.js").ManifestSectionView) | import("../dashboard/dashboard.extension.js").ManifestDashboard | import("../tree/types.js").ManifestEntityActionCreateFolderKind | import("../tree/types.js").ManifestEntityActionDeleteFolderKind | import("../tree/types.js").ManifestEntityActionUpdateFolderKind | import("../tree/types.js").ManifestEntityCreateOptionActionFolderKind | import("../menu/menu.extension.js").ManifestMenu | import("../menu/types.js").ManifestMenuItem | import("../menu/types.js").ManifestMenuItemActionKind | import("../menu/types.js").ManifestMenuItemLinkKind | import("../menu/types.js").ManifestWorkspaceContextMenuStructureKind | import("../tree/types.js").ManifestMenuItemTreeKind | import("../tree/types.js").ManifestTreeItemCard | import("../tree/types.js").ManifestWorkspaceViewTreeKind | import("../tree/index.js").ManifestTreeView | import("../tree/index.js").ManifestTreeViewTableKind | import("../collection/types.js").ManifestEntityCollectionItemCard<import("../collection/types.js").MetaEntityCollectionItemCard> | import("../collection/types.js").ManifestEntityCollectionItemRef<import("../collection/types.js").MetaEntityCollectionItemRef> | import("../collection/types.js").ManifestCollectionAction | import("../collection/types.js").ManifestCollectionActionCreateKind | import("../collection/types.js").ManifestCollectionTextFilter | import("../collection/types.js").ManifestWorkspaceViewCollectionKind | import("../value-summary/index.js").ManifestValueSummary | import("../../content/content/index.js").ManifestAuditLogAction<import("../../content/content/index.js").MetaAuditLogAction> | import("../../content/content/index.js").ManifestAuditLogActionDefaultKind | import("../../content/content/index.js").ManifestEntityActionContentRollbackKind | import("../../content/content/index.js").ManifestWorkspaceInfoAppAuditLogKind | import("../../content/content/index.js").ManifestWorkspaceViewContentCollectionKind | import("../../content/content/index.js").ManifestEntityActionSortChildrenOfContentKind | import("../../content/content/index.js").ManifestEntityActionContentPublishKind | import("../../user/current-user/index.js").ManifestUserProfileApp | import("../../user/current-user/index.js").ManifestCurrentUserAction<import("../../user/current-user/index.js").MetaCurrentUserAction> | import("../icon-registry/types.js").ManifestIcons | import("../../user/user-permission/index.js").ManifestEntityUserPermission | import("../../user/user-permission/index.js").ManifestGranularUserPermission | import("../localization/index.js").ManifestLocalization | import("../../content/content/index.js").ManifestEntityActionContentUnpublishKind | import("../picker/types.js").ManifestPickerSearchResultItem | import("../property-editor-data-source/types.js").ManifestPropertyEditorDataSource | import("../validation/types.js").ManifestPropertyValidationPathTranslator<any> | import("../entity-action/types.js").ManifestEntityActionDeleteKind | import("../entity-action/entity-action.extension.js").ManifestEntityAction<import("../entity-action/entity-action.extension.js").MetaEntityAction> | import("../entity-action/types.js").ManifestEntityActionDefaultKind | import("../entity-action/common/create/types.js").ManifestEntityActionCreateKind | import("../entity-bulk-action/types.js").ManifestEntityBulkActionDeleteKind | import("../extension-registry/index.js").UmbEntityBulkActionExtensions | import("../extension-registry/index.js").ManifestExternalLoginProvider | import("../extension-registry/index.js").ManifestGlobalContext | import("../extension-registry/index.js").ManifestHeaderApp | import("../extension-registry/index.js").ManifestHeaderAppButtonKind | import("../extension-registry/index.js").ManifestMfaLoginProvider | import("../extension-registry/index.js").ManifestPreviewAppProvider | import("../extension-registry/index.js").ManifestRepository<import("../../../libs/extension-api/index.js").UmbApi> | import("../extension-registry/index.js").UmbStoreExtensions | import("../search/types.js").ManifestSearchProvider | import("../search/types.js").ManifestSearchResultItem | import("../search/types.js").ManifestGlobalSearch | import("../auth/auth-provider.extension.js").ManifestAuthProvider | import("../themes/theme.extension.js").ManifestTheme | import("../entity-sign/types.js").ManifestEntitySign<import("../entity-sign/types.js").MetaEntitySign> | import("../entity-sign/kinds/types.js").ManifestEntitySignIconKind | import("../property-action/property-action.extension.js").UmbPropertyActionExtensions | import("../property-sort-mode/types.js").ManifestPropertyActionSortModeKind<import("../property-action/property-action.extension.js").MetaPropertyActionDefaultKind> | import("../recycle-bin/types.js").ManifestCollectionActionEmptyRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityActionTrashKind | import("../recycle-bin/types.js").ManifestEntityActionTrashFolderKind | import("../recycle-bin/types.js").ManifestEntityActionRestoreFromRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityActionEmptyRecycleBinKind | import("../recycle-bin/types.js").ManifestEntityBulkActionTrashKind | import("../recycle-bin/types.js").ManifestTreeItemRecycleBinKind | import("../server-file-system/types.js").ManifestEntityActionRenameServerFileKind | import("../property-sort-mode/types.js").ManifestPropertyContextSortModeKind | import("../../block/block/index.js").ManifestBlockAction<import("../../block/block/index.js").MetaBlockAction> | import("../../block/block/index.js").ManifestBlockActionDefaultKind | import("../../block/block-custom-view/index.js").ManifestBlockEditorCustomView | import("../../clipboard/index.js").ManifestClipboardCopyPropertyValueTranslator | import("../../clipboard/index.js").ManifestClipboardPastePropertyValueTranslator | import("../../clipboard/index.js").ManifestPropertyActionPasteFromClipboardKind | import("../../clipboard/index.js").ManifestPropertyActionCopyToClipboardKind | import("../../relations/relations/index.js").ManifestEntityBulkActionDeleteWithRelationKind | import("../../relations/relations/index.js").ManifestEntityBulkActionTrashWithRelationKind | import("../../relations/relations/index.js").ManifestEntityActionDeleteWithRelationKind | import("../../relations/relations/index.js").ManifestEntityActionTrashWithRelationKind | import("../../documents/documents/index.js").ManifestWorkspaceActionMenuItemPreviewOptionKind | import("../../media/media/index.js").ManifestFileUploadPreview | import("../../health-check/index.js").ManifestHealthCheck | import("../../packages/package/index.js").ManifestPackageView | import("../../property-editors/content-picker/index.js").ManifestDynamicRootOrigin | import("../../property-editors/content-picker/index.js").ManifestDynamicRootQueryStep | import("../../relations/relations/reference/workspace-info-app/types.js").ManifestWorkspaceInfoAppEntityReferencesKind | import("../../tiptap/index.js").ManifestTiptapExtension<import("../../tiptap/index.js").MetaTiptapExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtension<import("../../tiptap/index.js").MetaTiptapToolbarExtension> | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionMenuKind | import("../../tiptap/index.js").ManifestTiptapToolbarExtensionStyleMenuKind | import("../../tiptap/index.js").ManifestTiptapStatusbarExtension<import("../../tiptap/index.js").MetaTiptapStatusbarExtension> | import("../../clipboard/property/context/types.js").ManifestPropertyContextClipboardKind | import("../section/default/types.js").ManifestSectionDefaultKind | import("../../markdown-editor/index.js").ManifestMonacoMarkdownEditorAction)[];

package/dist-cms/packages/core/property/property-value-preset/property-value-preset-builder.controller.js

@@ -71,6 +71,9 @@ export class UmbPropertyValuePresetBuilderController extends UmbControllerBase {
     async _generatePropertyValue(apis, propertyType, incomingCallArgs) {
         let value = incomingCallArgs.value;
         // Only process value if it is `undefined`, if a property has a value we do not want to process it. [NL]
+        // TODO: For v.19, we should run presets for all value always. Make it up to the preset to decide if it should process the value or not. [NL]
+        // Consider how we should communicate such change, as some might have build their own presets that rely on the current behavior. [NL]
+        // notice the important difference between `undefined` and `null` here, as `null` is a valid value for a property, while `undefined` means that the property has no value. [NL]
         if (value === undefined) {
             const callArgs = {
                 ...this.#baseCreateArgs,

package/dist-cms/packages/core/property/types/property-value-data.type.d.ts

@@ -5,3 +5,7 @@ export interface UmbPropertyValueData<ValueType = unknown> {
 export interface UmbPropertyValueDataPotentiallyWithEditorAlias<ValueType = unknown> extends UmbPropertyValueData<ValueType> {
     editorAlias?: string;
 }
+export interface UmbPropertyValueDataWithVariant<ValueType = unknown> extends UmbPropertyValueData<ValueType> {
+    culture: string | null;
+    segment: string | null;
+}

package/dist-cms/packages/core/property-editor/extensions/property-editor-ui-element.interface.d.ts

@@ -2,6 +2,7 @@ import type { UmbPropertyEditorConfigCollection } from '../config/index.js';
 import type { ManifestPropertyEditorUi } from './property-editor.extension.js';
 export interface UmbPropertyEditorUiElement extends HTMLElement {
     manifest?: ManifestPropertyEditorUi;
+    alias?: string;
     name?: string;
     value?: unknown;
     dataSourceAlias?: string;

package/dist-cms/packages/core/property-editor/extensions/property-editor.extension.d.ts

@@ -9,10 +9,15 @@ export interface MetaPropertyEditorUi {
     label: string;
     icon: string;
     /**
-     * The group that this property editor UI belongs to, which will be used to group the property editor UIs in the property editor picker.
+     * The group that this property editor UI belongs to, which will be used to group
+     * the property editor UIs in the property editor picker.
      * If not specified, the property editor UI will be grouped under "Common".
+     *
+     * Core property editors use localization keys prefixed with `#` (e.g. `"#propertyEditorUIGroups_common"`).
+     * External packages can use either display-ready names (e.g. `"My Group"`) or camelCase names
+     * (e.g. `"myGroup"`) which will be automatically converted to title case.
      * @default "Common"
-     * @example ["Common", "Content", "Media"]
+     * @example ["#propertyEditorUIGroups_common", "#propertyEditorUIGroups_richContent", "My Custom Group"]
      */
     group: string;
     /**

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

@@ -15,6 +15,7 @@ export class UmbPropertyEditorUiInteractionMemoryManager extends UmbControllerBa
         this.#init = Promise.all([
             this.consumeContext(UMB_INTERACTION_MEMORY_CONTEXT, (context) => {
                 this.#interactionMemoryContext = context;
+                this.#observeInteractionMemory();
             }).asPromise(),
         ]);
     }
@@ -25,7 +26,7 @@ export class UmbPropertyEditorUiInteractionMemoryManager extends UmbControllerBa
      */
     setPropertyEditorConfig(config) {
         this.#setConfigHash(config);
-        this.#getInteractionMemory();
+        this.#observeInteractionMemory();
     }
     /**
      * Creates or updates an interaction memory for this property editor based on the provided memories.
@@ -58,15 +59,15 @@ export class UmbPropertyEditorUiInteractionMemoryManager extends UmbControllerBa
     #getInteractionMemoryUnique() {
         return `${this.#memoryUniquePrefix}PropertyEditorUi${this.#configHashCode ? '-' + this.#configHashCode : ''}`;
     }
-    async #getInteractionMemory() {
-        await this.#init;
+    async #observeInteractionMemory() {
+        if (!this.#interactionMemoryContext || !this.#configHashCode)
+            return;
         const memoryUnique = this.#getInteractionMemoryUnique();
         if (!memoryUnique)
             return;
-        if (!this.#interactionMemoryContext)
-            return;
-        const memory = this.#interactionMemoryContext.memory.getMemory(memoryUnique);
-        this.#memories.setValue(memory?.memories ?? []);
+        this.observe(this.#interactionMemoryContext?.memory.memory(memoryUnique), (memory) => {
+            this.#memories.setValue(memory?.memories ?? []);
+        }, 'observeMemory');
     }
     #setConfigHash(config) {
         const configString = config ? JSON.stringify(config.toObject()) : '';

package/dist-cms/packages/core/property-editor/ui-picker-modal/property-editor-ui-picker-modal.element.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { UmbPropertyEditorUISearchController } from './property-editor-ui-search.controller.js';
 import { css, customElement, html, repeat, state } from '../../../../external/lit/index.js';
-import { debounce, fromCamelCase } from '../../utils/index.js';
+import { debounce, fromCamelCaseIfCamelCase } from '../../utils/index.js';
 import { umbExtensionsRegistry } from '../../extension-registry/index.js';
 import { umbFocus } from '../../lit-element/index.js';
 import { UmbModalBaseElement } from '../../modal/index.js';
@@ -70,8 +70,15 @@ let UmbPropertyEditorUIPickerModalElement = class UmbPropertyEditorUIPickerModal
                 throw error;
         }
     }
+    #resolveGroupName(group) {
+        if (group.startsWith('#')) {
+            return this.localize.string(group);
+        }
+        // Backward compatibility: external packages may still register camelCase group names.
+        return fromCamelCaseIfCamelCase(group);
+    }
     #groupPropertyEditorUIs(items) {
-        const grouped = Object.groupBy(items, (propertyEditorUi) => fromCamelCase(propertyEditorUi.meta.group));
+        const grouped = Object.groupBy(items, (propertyEditorUi) => this.#resolveGroupName(propertyEditorUi.meta.group));
         this._groupedPropertyEditorUIs = Object.entries(grouped)
             .sort(([a], [b]) => a.localeCompare(b))
             .map(([key, items]) => ({ key, items: items ?? [] }));

package/dist-cms/packages/core/property-editor-data-source/input/input-property-editor-data-source.element.d.ts

@@ -12,7 +12,7 @@ export declare class UmbInputPropertyEditorDataSourceElement extends UmbInputPro
     get min(): number;
     /**
      * Min validation message.
-     * @type {boolean}
+     * @type {string}
      * @attr
      * @default
      */
@@ -27,7 +27,7 @@ export declare class UmbInputPropertyEditorDataSourceElement extends UmbInputPro
     get max(): number;
     /**
      * Max validation message.
-     * @type {boolean}
+     * @type {string}
      * @attr
      * @default
      */

package/dist-cms/packages/core/property-editor-data-source/input/input-property-editor-data-source.element.js

@@ -95,14 +95,14 @@ let UmbInputPropertyEditorDataSourceElement = class UmbInputPropertyEditorDataSo
         });
         /**
          * Min validation message.
-         * @type {boolean}
+         * @type {string}
          * @attr
          * @default
          */
-        this.minMessage = 'This field need more items';
+        this.minMessage = 'This field needs more items';
         /**
          * Max validation message.
-         * @type {boolean}
+         * @type {string}
          * @attr
          * @default
          */

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

@@ -2,6 +2,7 @@ export * from './constants.js';
 export * from './data-mapper/index.js';
 export * from './detail/index.js';
 export * from './item/index.js';
+export * from './pagination/index.js';
 export * from './repository-base.js';
 export * from './repository-details.manager.js';
 export * from './repository-items.manager.js';

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

@@ -2,6 +2,7 @@ export * from './constants.js';
 export * from './data-mapper/index.js';
 export * from './detail/index.js';
 export * from './item/index.js';
+export * from './pagination/index.js';
 export * from './repository-base.js';
 export * from './repository-details.manager.js';
 export * from './repository-items.manager.js';

package/dist-cms/packages/core/repository/pagination/fetch-all-pages.function.d.ts

@@ -0,0 +1,22 @@
+import type { UmbDataSourceResponse } from '../data-source-response.interface.js';
+import type { UmbPagedModel } from '../types.js';
+/**
+ * A function that returns a single page of an offset-paginated collection.
+ * @template T - The type of items in the page.
+ */
+export type UmbOffsetPageFetcher<T> = (skip: number, take: number) => Promise<UmbDataSourceResponse<UmbPagedModel<T>>>;
+/**
+ * Pages through an offset-paginated data source, accumulating every item until `total` has been reached.
+ * Use when a caller genuinely needs the full set rather than a single page — for example, populating a
+ * dropdown of every configured language. Returns the same `{ data: { items, total } }` shape as a
+ * single-page fetch, or `{ error }` if any page fails.
+ *
+ * If the server reports a higher `total` than it actually delivers — i.e. an empty page is returned
+ * before `allItems.length` reaches `total` — the function fails with an error rather than silently
+ * truncating, since a partial "fetch all" result would mislead the caller.
+ * @param {UmbOffsetPageFetcher} fetchPage - Called once per page with the current `skip` and `take`.
+ * @param {number} take - Page size used for every request. Must be a positive finite number.
+ * @returns {Promise} A promise resolving to all items, or the first error encountered.
+ * @throws {RangeError} If `take` is not a positive finite number.
+ */
+export declare function fetchAllPages<T>(fetchPage: UmbOffsetPageFetcher<T>, take: number): Promise<UmbDataSourceResponse<UmbPagedModel<T>>>;

package/dist-cms/packages/core/repository/pagination/fetch-all-pages.function.js

@@ -0,0 +1,40 @@
+/**
+ * Pages through an offset-paginated data source, accumulating every item until `total` has been reached.
+ * Use when a caller genuinely needs the full set rather than a single page — for example, populating a
+ * dropdown of every configured language. Returns the same `{ data: { items, total } }` shape as a
+ * single-page fetch, or `{ error }` if any page fails.
+ *
+ * If the server reports a higher `total` than it actually delivers — i.e. an empty page is returned
+ * before `allItems.length` reaches `total` — the function fails with an error rather than silently
+ * truncating, since a partial "fetch all" result would mislead the caller.
+ * @param {UmbOffsetPageFetcher} fetchPage - Called once per page with the current `skip` and `take`.
+ * @param {number} take - Page size used for every request. Must be a positive finite number.
+ * @returns {Promise} A promise resolving to all items, or the first error encountered.
+ * @throws {RangeError} If `take` is not a positive finite number.
+ */
+export async function fetchAllPages(fetchPage, take) {
+    if (!Number.isFinite(take) || take <= 0) {
+        throw new RangeError(`fetchAllPages: \`take\` must be a positive finite number, got ${take}.`);
+    }
+    const allItems = [];
+    let skip = 0;
+    let total = Number.POSITIVE_INFINITY;
+    while (allItems.length < total) {
+        const { data, error } = await fetchPage(skip, take);
+        if (error)
+            return { error };
+        if (!data)
+            return { error: new Error('fetchAllPages: page fetcher returned neither data nor error.') };
+        // If the server reports more items than it delivers, fail rather than silently truncating —
+        // also guards against an infinite loop on a misbehaving source.
+        if (data.items.length === 0 && allItems.length < data.total) {
+            return {
+                error: new Error(`fetchAllPages: page fetcher returned an empty page after ${allItems.length} items but reported a total of ${data.total}.`),
+            };
+        }
+        allItems.push(...data.items);
+        total = data.total;
+        skip += data.items.length;
+    }
+    return { data: { items: allItems, total: allItems.length } };
+}

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

@@ -0,0 +1 @@
+export * from './fetch-all-pages.function.js';

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

@@ -0,0 +1 @@
+export * from './fetch-all-pages.function.js';