@progress/kendo-angular-common 25.0.0-develop.17 → 25.0.0-develop.19

package/fesm2022/progress-kendo-angular-common.mjs

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from '@angular/core';
-import { afterNextRender, EventEmitter, signal, Output, Input, Directive, Injectable, ChangeDetectionStrategy, Component, InjectionToken, HostBinding, ViewChild, Optional, isDevMode } from '@angular/core';
+import { afterNextRender, EventEmitter, signal, Output, Input, Directive, Injectable, ChangeDetectionStrategy, Component, InjectionToken, HostBinding, ViewChild, Optional, isDevMode, SkipSelf, Inject } from '@angular/core';
 import { detectDesktopBrowser, detectMobileOS } from '@progress/kendo-common';
 import { Draggable } from '@progress/kendo-draggable';
 import { auditTime } from 'rxjs/operators';
@@ -2261,9 +2261,90 @@ const KENDO_TEMPLATE_CONTEXT = [
  */
 const replaceMessagePlaceholder = (message, name, value) => (message ?? '').replace(new RegExp(`\\[\\[\\s*${name}\\s*]]|{\\s*${name}\\s*}`, 'g'), value);
 
+/**
+ * An injection token that holds the accumulated component ancestry chain (outermost -> innermost).
+ * Kendo components add their identifier to the chain through `provideComponentName`.
+ * Used internally by features that need to forward component context to a service (for example,
+ * per-component icon overrides).
+ *
+ * @hidden
+ */
+const KENDO_COMPONENT_NAME = new InjectionToken('Kendo Component Name');
+/**
+ * Adds `name` to the ancestry chain provided by any parent component, so nested components
+ * automatically accumulate the full ancestry chain without any coordination between packages.
+ *
+ * @hidden
+ */
+function provideComponentName(name) {
+    return {
+        provide: KENDO_COMPONENT_NAME,
+        useFactory: (parentChain) => parentChain ? [...parentChain, name] : [name],
+        deps: [[new Optional(), new SkipSelf(), KENDO_COMPONENT_NAME]]
+    };
+}
+
+/**
+ * Appends a component identifier to the icon component-name ancestry chain for a template subtree.
+ *
+ * Use this directive when a component declares a template at its own root but that template is rendered
+ * inside a different (child) component through `ngTemplateOutlet` — for example, the default Pager
+ * template that the Grid and TreeList declare and the Pager renders. Because an embedded view resolves
+ * element-level DI from its lexical declaration site, the rendering component would otherwise be missing
+ * from the ancestry chain and per-component icon overrides for it would not apply. Wrap the projected
+ * content with this directive to restore the missing segment.
+ *
+ * @hidden
+ */
+class ComponentNameDirective {
+    /**
+     * The component identifier to append to the ancestry chain.
+     */
+    name;
+    parentChain;
+    constructor(parentChain) {
+        this.parentChain = parentChain;
+    }
+    /**
+     * The accumulated ancestry chain including this component identifier.
+     */
+    get chain() {
+        const parent = this.parentChain ?? [];
+        return this.name ? [...parent, this.name] : parent;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.26", ngImport: i0, type: ComponentNameDirective, deps: [{ token: KENDO_COMPONENT_NAME, optional: true, skipSelf: true }], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.26", type: ComponentNameDirective, isStandalone: true, selector: "[kendoComponentName]", inputs: { name: ["kendoComponentName", "name"] }, providers: [{
+                provide: KENDO_COMPONENT_NAME,
+                useFactory: (directive) => directive.chain,
+                deps: [ComponentNameDirective]
+            }], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.26", ngImport: i0, type: ComponentNameDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[kendoComponentName]',
+                    standalone: true,
+                    providers: [{
+                            provide: KENDO_COMPONENT_NAME,
+                            useFactory: (directive) => directive.chain,
+                            deps: [ComponentNameDirective]
+                        }]
+                }]
+        }], ctorParameters: () => [{ type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: SkipSelf
+                }, {
+                    type: Inject,
+                    args: [KENDO_COMPONENT_NAME]
+                }] }], propDecorators: { name: [{
+                type: Input,
+                args: ['kendoComponentName']
+            }] } });
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { ScrollbarService as BrowserSupportService, DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KENDO_WEBMCP_HOST, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasFocusableParent, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isSet, isString, isVisible, matchesClasses, matchesNodeName, normalizeKeys, parseAttributes, parseCSSClassNames, processCssValue, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollLeft, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
+export { ScrollbarService as BrowserSupportService, ComponentNameDirective, DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_COMPONENT_NAME, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KENDO_WEBMCP_HOST, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasFocusableParent, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isSet, isString, isVisible, matchesClasses, matchesNodeName, normalizeKeys, parseAttributes, parseCSSClassNames, processCssValue, provideComponentName, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollLeft, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
 

package/index.d.ts

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 import * as i0 from '@angular/core';
-import { OnDestroy, EventEmitter, ElementRef, NgZone, OnInit, Renderer2, AfterViewChecked, InjectionToken, SimpleChanges, Injector, AfterViewInit, TemplateRef, ViewContainerRef } from '@angular/core';
+import { OnDestroy, EventEmitter, ElementRef, NgZone, OnInit, Renderer2, AfterViewChecked, InjectionToken, SimpleChanges, Injector, AfterViewInit, TemplateRef, ViewContainerRef, Provider } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { LicenseMessage, PackageMetadata } from '@progress/kendo-licensing';
 
@@ -775,5 +775,49 @@ declare const KENDO_TEMPLATE_CONTEXT: readonly [typeof TemplateContextDirective]
  */
 declare const replaceMessagePlaceholder: (message: string, name: string, value: string) => string;
 
-export { ScrollbarService as BrowserSupportService, DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KENDO_WEBMCP_HOST, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasFocusableParent, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isSet, isString, isVisible, matchesClasses, matchesNodeName, normalizeKeys, parseAttributes, parseCSSClassNames, processCssValue, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollLeft, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
+/**
+ * An injection token that holds the accumulated component ancestry chain (outermost -> innermost).
+ * Kendo components add their identifier to the chain through `provideComponentName`.
+ * Used internally by features that need to forward component context to a service (for example,
+ * per-component icon overrides).
+ *
+ * @hidden
+ */
+declare const KENDO_COMPONENT_NAME: InjectionToken<string[]>;
+/**
+ * Adds `name` to the ancestry chain provided by any parent component, so nested components
+ * automatically accumulate the full ancestry chain without any coordination between packages.
+ *
+ * @hidden
+ */
+declare function provideComponentName(name: string): Provider;
+
+/**
+ * Appends a component identifier to the icon component-name ancestry chain for a template subtree.
+ *
+ * Use this directive when a component declares a template at its own root but that template is rendered
+ * inside a different (child) component through `ngTemplateOutlet` — for example, the default Pager
+ * template that the Grid and TreeList declare and the Pager renders. Because an embedded view resolves
+ * element-level DI from its lexical declaration site, the rendering component would otherwise be missing
+ * from the ancestry chain and per-component icon overrides for it would not apply. Wrap the projected
+ * content with this directive to restore the missing segment.
+ *
+ * @hidden
+ */
+declare class ComponentNameDirective {
+    /**
+     * The component identifier to append to the ancestry chain.
+     */
+    name: string;
+    private parentChain;
+    constructor(parentChain: string[]);
+    /**
+     * The accumulated ancestry chain including this component identifier.
+     */
+    get chain(): string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ComponentNameDirective, [{ optional: true; skipSelf: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ComponentNameDirective, "[kendoComponentName]", never, { "name": { "alias": "kendoComponentName"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { ScrollbarService as BrowserSupportService, ComponentNameDirective, DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_COMPONENT_NAME, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KENDO_WEBMCP_HOST, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasFocusableParent, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isSet, isString, isVisible, matchesClasses, matchesNodeName, normalizeKeys, parseAttributes, parseCSSClassNames, processCssValue, provideComponentName, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollLeft, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
 export type { SeparatorOrientation };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-common",
-  "version": "25.0.0-develop.17",
+  "version": "25.0.0-develop.19",
   "description": "Kendo UI for Angular - Utility Package",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -23,7 +23,7 @@
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-draggable": "^3.0.2",
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "25.0.0-develop.17"
+    "@progress/kendo-angular-schematics": "25.0.0-develop.19"
   },
   "publishConfig": {
     "access": "public"