primeng 22.1.2 → 22.1.3

package/types/primeng-basecomponent.d.ts

@@ -4,6 +4,8 @@ import { cn } from "@primeuix/utils";
 import { Lifecycle, PassThroughOptions } from "primeng/api";
 import { BaseStyle } from "primeng/base";
 import { PrimeNG } from "primeng/config";
+import { UseId } from "primeng/useid";
+import { StyleScope } from "primeng/usestyle";
 export declare class BaseComponentStyle extends BaseStyle {
   name: string;
   static ɵfac: i0.ɵɵFactoryDeclaration<BaseComponentStyle, never>;
@@ -21,14 +23,16 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
   $parentInstance: BaseComponent | undefined;
   baseComponentStyle: BaseComponentStyle;
   baseStyle: BaseStyle;
+  protected readonly $styleScope: StyleScope;
   scopedStyleEl: any;
+  private _scopedStyleName;
   parent: {
     instance: any;
   };
   protected readonly cn: typeof cn;
   private _themeScopedListener;
+  private _instanceStyles;
   private themeChangeListenerMap;
-  /******************** Inputs ********************/
   /**
    * Defines scoped design tokens of the component.
    * @defaultValue undefined
@@ -54,6 +58,7 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
    */
   ptOptions: import("@angular/core").InputSignal<PassThroughOptions | undefined>;
   /******************** Computed ********************/
+  protected readonly $useId: UseId;
   $attrSelector: string;
   get $name(): any;
   private get $hostName();
@@ -76,7 +81,6 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
       instance: any;
     };
   };
-  /******************** Lifecycle Hooks ********************/
   onInit(): void;
   onChanges(_changes: SimpleChanges): void;
   onDoCheck(): void;
@@ -85,66 +89,64 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
   onAfterViewInit(): void;
   onAfterViewChecked(): void;
   onDestroy(): void;
-  /******************** Angular Lifecycle Hooks ********************/
   constructor();
   /**
-   * ⚠ Do not override ngOnInit!
+   * Do not override ngOnInit!
    *
    * Use 'onInit()' in subclasses instead.
    */
   ngOnInit(): void;
   /**
-   * ⚠ Do not override ngOnChanges!
+   * Do not override ngOnChanges!
    *
    * Use 'onChanges(changes: SimpleChanges)' in subclasses instead.
    */
   ngOnChanges(changes: SimpleChanges): void;
   /**
-   * ⚠ Do not override ngDoCheck!
+   * Do not override ngDoCheck!
    *
    * Use 'onDoCheck()' in subclasses instead.
    */
   ngDoCheck(): void;
   /**
-   * ⚠ Do not override ngAfterContentInit!
+   * Do not override ngAfterContentInit!
    *
    * Use 'onAfterContentInit()' in subclasses instead.
    */
   ngAfterContentInit(): void;
   /**
-   * ⚠ Do not override ngAfterContentChecked!
+   * Do not override ngAfterContentChecked!
    *
    * Use 'onAfterContentChecked()' in subclasses instead.
    */
   ngAfterContentChecked(): void;
   /**
-   * ⚠ Do not override ngAfterViewInit!
+   * Do not override ngAfterViewInit!
    *
    * Use 'onAfterViewInit()' in subclasses instead.
    */
   ngAfterViewInit(): void;
   /**
-   * ⚠ Do not override ngAfterViewChecked!
+   * Do not override ngAfterViewChecked!
    *
    * Use 'onAfterViewChecked()' in subclasses instead.
    */
   ngAfterViewChecked(): void;
   /**
-   * ⚠ Do not override ngOnDestroy!
+   * Do not override ngOnDestroy!
    *
    * Use 'onDestroy()' in subclasses instead.
    */
   ngOnDestroy(): void;
-  /******************** Methods ********************/
   private _mergeProps;
   private _getHostInstance;
   private _getPropValue;
   private _getOptionValue;
   private _hook;
-  /********** Load Styles **********/
+  private get $theme();
+  private get $base();
   private _load;
   private _loadStyles;
-  private _shareStylesWithShadowRoot;
   private _loadGlobalStyles;
   private _loadCoreStyles;
   private _loadThemeStyles;
@@ -153,7 +155,6 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
   private _themeChangeListener;
   private _removeThemeListeners;
   private _offThemeChangeListener;
-  /********** Passthrough **********/
   private _getPTValue;
   private _getPTDatasets;
   private _getPTClassValue;
@@ -161,14 +162,31 @@ export declare class BaseComponent<PT = any> implements Lifecycle {
   private _usePT;
   private _useGlobalPT;
   private _useDefaultPT;
-  /******************** Exposed API ********************/
   ptm(key?: string, params?: {}): any;
   ptms(keys: string[], params?: {}): {};
   ptmo(obj?: {}, key?: string, params?: {}): any;
   cx(key: string, params?: {}): string | undefined;
+  pcn(...classes: unknown[]): string;
+  psel<T extends string | null | undefined>(selector: T): T;
+  protected get $bodyScrollOptions(): {
+    className: string;
+    variableName: string;
+  } | undefined;
+  protected $blockBodyScroll(): void;
+  protected $unblockBodyScroll(): void;
   sx(key?: string, when?: boolean, params?: {}): {
     [x: string]: any;
   } | undefined;
+  /**
+   * Adds this instance's id to `data-pc-id` on an element it renders outside its host, such as an overlay.
+   *
+   * @param el The element.
+   */
+  protected $markInstance(el: Element | null | undefined): void;
+  protected get $instanceSelector(): string;
+  protected $keyedId(id: string): string;
+  protected $isolatedStyle(name: string, css: string | null): void;
+  protected $overlayParent<T>(target: T, overlay?: Element | null): T;
   translate(key: string, subKey?: string): any;
   static ɵfac: i0.ɵɵFactoryDeclaration<BaseComponent<any>, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<BaseComponent<any>, never, never, {

package/types/primeng-button.d.ts

@@ -34,7 +34,13 @@ export declare class ButtonStyle extends BaseStyle {
     loadingIcon: string;
     icon: ({ instance }: {
       instance: any;
-    }) => any[];
+    }) => (string | {
+      [x: string]: any;
+      'p-button-icon-left': any;
+      'p-button-icon-right': any;
+      'p-button-icon-top': any;
+      'p-button-icon-bottom': any;
+    })[];
     spinnerIcon: ({ instance }: {
       instance: any;
     }) => string;
@@ -70,9 +76,6 @@ export declare enum ButtonClasses {
    */
   label = "p-button-label"
 }
-declare namespace button_component_d_exports {
-  export { BUTTON_INSTANCE, Button };
-}
 export declare const BUTTON_INSTANCE: InjectionToken<Button>;
 /**
  * @deprecated Use the `[pButton]` directive instead.
@@ -432,9 +435,6 @@ export declare class Button extends BaseComponent<ButtonPassThrough> {
     outputs: {};
   }]>;
 }
-declare namespace button_label_d_exports {
-  export { BUTTON_LABEL_INSTANCE, ButtonLabel };
-}
 export declare const BUTTON_LABEL_INSTANCE: InjectionToken<ButtonLabel>;
 /**
  * ButtonLabel is a directive to apply label styling to an element inside a button.
@@ -480,15 +480,12 @@ export declare class ButtonLabel extends BaseComponent {
     outputs: {};
   }]>;
 }
-declare namespace button_icon_d_exports {
-  export { BUTTON_ICON_INSTANCE, ButtonIcon };
-}
 export declare const BUTTON_ICON_INSTANCE: InjectionToken<ButtonIcon>;
 /**
  * ButtonIcon is a directive to apply icon styling to an element inside a button.
  *
  * @deprecated Since v21. Place the icon (`<svg>`, `<i>`, or any element) directly
- * inside the `[pButton]` host — use the `iconOnly` prop to enable icon-only styling.
+ * inside the `[pButton]` host; use the `iconOnly` prop to enable icon-only styling.
  * The `pButtonIcon` directive will be removed in a future major release.
  *
  * @group Directives
@@ -537,7 +534,7 @@ export declare class ButtonDirective extends BaseComponent {
   componentName: string;
   /**
    * Bound configuration object. Fields win over the individual styling inputs
-   * (`text`, `raised`, `severity`, …); unset fields fall back to those inputs.
+   * (`text`, `raised`, `severity`, ...); unset fields fall back to those inputs.
    * @group Props
    */
   pButton: import("@angular/core").InputSignal<string | ButtonDirectiveOptions | undefined>;

package/types/primeng-carousel.d.ts

@@ -10,9 +10,6 @@ import { ButtonDirectiveOptions } from "primeng/types/button";
 import { CSSProperties } from "primeng/types/shared";
 import { BaseStyle } from "primeng/base";
 export * from "primeng/types/carousel";
-declare namespace carousel_content_d_exports {
-  export { CarouselContent };
-}
 /**
  * CarouselContent is the scrollable track element that contains carousel items.
  * @group Components
@@ -89,18 +86,14 @@ export declare class CarouselStyle extends BaseStyle {
     }) => (string | {
       'p-disabled': any;
     })[];
-    indicatorList: ({ instance }: {
-      instance: any;
-    }) => any[];
+    indicatorList: string;
     indicator: ({ instance, index }: {
       instance: any;
       index: any;
     }) => (string | {
       'p-carousel-indicator-active': boolean;
     })[];
-    indicatorButton: ({ instance }: {
-      instance: any;
-    }) => any[];
+    indicatorButton: string;
     footer: string;
     compositionRoot: string;
     compositionIndicator: ({ instance, index }: {
@@ -523,9 +516,6 @@ declare abstract class CarouselLegacyBase extends BaseComponent {
     "onPage": "onPage";
   }, ["headerFacet", "footerFacet", "itemTemplate", "headerTemplate", "footerTemplate", "previousIconTemplate", "nextIconTemplate"], never, true, never>;
 }
-declare namespace carousel_item_d_exports {
-  export { CarouselItem };
-}
 /**
  * CarouselItem represents an individual item in the composition-based carousel.
  * @group Components
@@ -560,9 +550,6 @@ export declare class CarouselItem extends BaseComponent<CarouselItemPassThrough>
     outputs: {};
   }]>;
 }
-declare namespace carousel_next_d_exports {
-  export { CarouselNext };
-}
 /**
  * CarouselNext is a directive for the next navigation button.
  * @group Directives
@@ -582,9 +569,6 @@ export declare class CarouselNext extends BaseComponent<CarouselNextPassThrough>
   static ɵfac: i0.ɵɵFactoryDeclaration<CarouselNext, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<CarouselNext, "[pCarouselNext]", never, {}, {}, never, never, true, never>;
 }
-declare namespace carousel_prev_d_exports {
-  export { CarouselPrev };
-}
 /**
  * CarouselPrev is a directive for the previous navigation button.
  * @group Directives
@@ -604,9 +588,6 @@ export declare class CarouselPrev extends BaseComponent<CarouselPrevPassThrough>
   static ɵfac: i0.ɵɵFactoryDeclaration<CarouselPrev, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<CarouselPrev, "[pCarouselPrev]", never, {}, {}, never, never, true, never>;
 }
-declare namespace carousel_indicators_d_exports {
-  export { CarouselIndicators };
-}
 /**
  * CarouselIndicators renders the list of page indicators.
  * Auto-generates button indicators based on snap points.
@@ -616,7 +597,7 @@ export declare class CarouselIndicators extends BaseComponent<CarouselIndicators
   componentName: string;
   bindDirectiveInstance: Bind;
   root: any;
-  hostClass: import("@angular/core").Signal<any>;
+  hostClass: import("@angular/core").Signal<string>;
   dataOrientation: import("@angular/core").Signal<any>;
   dataAlign: import("@angular/core").Signal<any>;
   dataPage: import("@angular/core").Signal<any>;
@@ -630,9 +611,6 @@ export declare class CarouselIndicators extends BaseComponent<CarouselIndicators
     outputs: {};
   }]>;
 }
-declare namespace carousel_indicator_d_exports {
-  export { CarouselIndicator };
-}
 /**
  * CarouselIndicator is a directive for an individual page indicator button.
  * @group Directives

package/types/primeng-compare.d.ts

@@ -55,9 +55,6 @@ export declare enum CompareClasses {
    */
   input = "p-compare-input"
 }
-declare namespace compare_item_d_exports {
-  export { CompareItem };
-}
 /**
  * CompareItem is a helper component for Compare component.
  * @group Components
@@ -87,9 +84,6 @@ export declare class CompareItem extends BaseComponent {
     outputs: {};
   }]>;
 }
-declare namespace compare_handle_d_exports {
-  export { CompareHandle };
-}
 /**
  * CompareHandle is a helper component for Compare component.
  * @group Components
@@ -111,9 +105,6 @@ export declare class CompareHandle extends BaseComponent {
     outputs: {};
   }]>;
 }
-declare namespace compare_indicator_d_exports {
-  export { CompareIndicator };
-}
 /**
  * CompareIndicator is a helper component for Compare component.
  * @group Components

package/types/primeng-config.d.ts

@@ -83,7 +83,8 @@ import { TreeSelectPassThrough } from "primeng/types/treeselect";
 import { TreeTablePassThrough } from "primeng/types/treetable";
 import { BaseStyle } from "primeng/base";
 import * as i0 from "@angular/core";
-import { EnvironmentProviders, InjectionToken } from "@angular/core";
+import { EnvironmentProviders, InjectionToken, Provider } from "@angular/core";
+import { Isolation } from "@primeuix/styled/isolation";
 /** ZIndex configuration */
 export type ZIndex = {
   modal: number;
@@ -261,6 +262,8 @@ export declare class ThemeProvider {
   isThemeChanged: boolean;
   document: Document;
   baseStyle: BaseStyle;
+  private readonly styleScope;
+  private readonly clearCoreStyleNames;
   constructor();
   ngOnDestroy(): void;
   onThemeChange(value: any): void;
@@ -300,4 +303,26 @@ export declare class PrimeNG extends ThemeProvider {
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
 export declare const PRIME_NG_CONFIG: InjectionToken<PrimeNGConfigType>;
-export declare function providePrimeNG(...features: PrimeNGConfigType[]): EnvironmentProviders;
+/**
+ * A feature `providePrimeNG` installs next to the configuration, e.g. `withIsolation()` from `primeng/isolation`.
+ * @group Interface
+ */
+export interface PrimeNGFeature {
+  readonly ɵproviders: (Provider | EnvironmentProviders)[];
+}
+export declare function providePrimeNG(...features: (PrimeNGConfigType | PrimeNGFeature)[]): EnvironmentProviders;
+/**
+ * Returns the isolation of the current application, or `undefined` when it does not use isolated mode.
+ * Call it in an injection context.
+ *
+ * @returns The application's isolation.
+ *
+ * @example
+ * const isolation = injectIsolation();
+ * inject(DestroyRef).onDestroy(isolation?.retain(shadowRoot) ?? (() => {}));
+ *
+ * @experimental
+ * @group Function
+ */
+export declare function injectIsolation(): Isolation | undefined;
+export type { Isolation };

package/types/primeng-confirmdialog.d.ts

@@ -314,6 +314,7 @@ export declare class ConfirmDialog extends BaseComponent<ConfirmDialogPassThroug
   option(name: string, k?: string): any;
   getButtonStyleClass(cx: string, opt: string): string;
   createStyle(): void;
+  private breakpointsCSS;
   close(): void;
   hide(type?: ConfirmEventType): void;
   onDialogHide(): void;

package/types/primeng-confirmpopup.d.ts

@@ -19,9 +19,7 @@ export declare class ConfirmPopupStyle extends BaseStyle {
   classes: {
     root: () => string[];
     content: string;
-    icon: ({ instance }: {
-      instance: any;
-    }) => any[];
+    icon: string;
     message: string;
     footer: string;
     pcRejectButton: string;

package/types/primeng-datepicker.d.ts

@@ -683,12 +683,6 @@ export declare class DatePicker extends BaseInput<DatePickerPassThrough, Date |
   disabledAttr: import("@angular/core").Signal<"" | undefined>;
   switchViewButtonDisabledAttr: import("@angular/core").Signal<"" | undefined>;
   inputModeAttr: import("@angular/core").Signal<"off" | null>;
-  /**
-   * The clear icon stays in the DOM whenever clearing is enabled — hidden via
-   * `visibility` while there is no value — so the base `:has(.p-datepicker-clear-icon)`
-   * rules reserve its footprint constantly and the control width does not jump
-   * when the icon appears (#6).
-   */
   clearIconEnabled: import("@angular/core").Signal<boolean>;
   showClearIcon: import("@angular/core").Signal<boolean>;
   showIconButton: import("@angular/core").Signal<boolean | undefined>;
@@ -794,12 +788,7 @@ export declare class DatePicker extends BaseInput<DatePickerPassThrough, Date |
   constructor();
   inputFieldValue: import("@angular/core").WritableSignal<string | null>;
   getDateTemplateContext(date: DatePickerDateMeta): DatePickerDateTemplateContext;
-  dayClass(date: any): {
-    [x: string]: any;
-    'p-datepicker-day': boolean;
-    'p-datepicker-day-selected': any;
-    'p-disabled': any;
-  };
+  dayClass(date: any): string;
   getPrevButtonStyle(index: number): {
     visibility: string;
   };
@@ -909,6 +898,7 @@ export declare class DatePicker extends BaseInput<DatePickerPassThrough, Date |
   repeat(event: Event | null, interval: number | null, type: number | null, direction: number | null): void;
   clearTimePickerTimer(): void;
   decrementHour(event: any): void;
+  stepHourWithinBounds(step: number, event: any): void;
   incrementMinute(event: any): void;
   decrementMinute(event: any): void;
   incrementSecond(event: any): void;

package/types/primeng-dialog.d.ts

@@ -436,6 +436,7 @@ export declare class Dialog extends BaseComponent<DialogPassThrough> {
   unbindMaskClickListener(): void;
   moveOnTop(): void;
   createStyle(): void;
+  private breakpointsCSS;
   initDrag(event: MouseEvent): void;
   onDrag(event: MouseEvent): void;
   endDrag(event: DragEvent): void;

package/types/primeng-dom.d.ts

@@ -1,11 +1,4 @@
-/**
- * @dynamic is for runtime initializing DomHandler.browser
- *
- * If delete below comment, we can see this error message:
- *  Metadata collected contains an error that will be reported at runtime:
- *  Only initialized variables and constants can be referenced
- *  because the value of this variable is needed by the template compiler.
- */
+import { BlockBodyScrollOptions } from "@primeuix/utils/dom";
 export declare class DomHandler {
   static zindex: number;
   private static calculatedScrollbarWidth;
@@ -93,8 +86,8 @@ export declare class DomHandler {
   static setAttributes(element: any, attributes?: {}): void;
   static isFocusableElement(element: any, selector?: string): any;
 }
-export declare function blockBodyScroll(): void;
-export declare function unblockBodyScroll(): void;
+export declare function blockBodyScroll(options?: BlockBodyScrollOptions): void;
+export declare function unblockBodyScroll(options?: BlockBodyScrollOptions): void;
 export declare class ConnectedOverlayScrollHandler {
   element: any;
   listener: any;
@@ -103,4 +96,6 @@ export declare class ConnectedOverlayScrollHandler {
   bindScrollListener(): void;
   unbindScrollListener(): void;
   destroy(): void;
-}
+}
+export declare function getShadowRoot(el: unknown): ShadowRoot | null;
+export declare function getEventTarget<T = any>(event: Event | null | undefined, element: unknown): T;

package/types/primeng-dragdrop.d.ts

@@ -115,6 +115,7 @@ export declare class Droppable implements AfterViewInit, OnDestroy {
   onDrop: EventEmitter<DragEvent>;
   el: ElementRef<any>;
   private renderer;
+  private styleScope;
   dragOverListener: VoidListener;
   ngAfterViewInit(): void;
   bindDragOverListener(): void;

package/types/primeng-dynamicdialog.d.ts

@@ -536,6 +536,7 @@ export declare class DialogService {
   private appRef;
   private injector;
   private document;
+  private styleScope;
   /**
    * Displays the dialog using the dynamic dialog object options.
    * @param {*} componentType - Dynamic component for content template.
@@ -561,4 +562,5 @@ export declare class DynamicDialogInjector implements Injector {
   private _additionalTokens;
   constructor(_parentInjector: Injector, _additionalTokens: WeakMap<any, any>);
   get<T>(token: ProviderToken<T>, notFoundValue?: T, _options?: InjectOptions): T;
-}
+}
+export {};

package/types/primeng-focustrap.d.ts

@@ -15,7 +15,7 @@ export declare class FocusTrap extends BaseComponent {
   constructor();
   onInit(): void;
   removeHiddenFocusableElements(): void;
-  getComputedSelector(selector: string | null): string;
+  getComputedSelector(selector: string | null): `:not(.p-hidden-focusable):not([data-p-hidden-focusable="true"])${string}`;
   createHiddenFocusableElements(): void;
   onFirstHiddenElementFocus(event: FocusEvent): void;
   onLastHiddenElementFocus(event: FocusEvent): void;