fix: missing public API exports - calendar resources, placement, tree args

Author: damyanpetev

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Fixed
 - Setting validation properties on a pristine non-dirty form associated element does not apply invalid styles [#1632](https://github.com/IgniteUI/igniteui-webcomponents/issues/1632)
+- Exposed `IgcCalendarResourceStrings`, `PopoverPlacement` (Dropdown and Select) and `IgcTreeSelectionEventArgs` from the public API
 
 ## [5.3.0] - 2025-03-13
 ### Added

src/components/common/util.ts

@@ -334,3 +334,8 @@ export function roundByDPR(value: number): number {
   const dpr = globalThis.devicePixelRatio || 1;
   return Math.round(value * dpr) / dpr;
 }
+
+/** Required utility type for specific props */
+export type RequiredProps<T, K extends keyof T> = T & {
+  [P in K]-?: T[P];
+};

src/components/dropdown/dropdown.ts

@@ -34,7 +34,9 @@ import {
   getElementByIdFromRoot,
   isString,
 } from '../common/util.js';
-import IgcPopoverComponent, { type IgcPlacement } from '../popover/popover.js';
+import IgcPopoverComponent, {
+  type PopoverPlacement,
+} from '../popover/popover.js';
 import IgcDropdownGroupComponent from './dropdown-group.js';
 import IgcDropdownHeaderComponent from './dropdown-header.js';
 import IgcDropdownItemComponent from './dropdown-item.js';
@@ -123,7 +125,7 @@ export default class IgcDropdownComponent extends EventEmitterMixin<
    * @attr
    */
   @property()
-  public placement: IgcPlacement = 'bottom-start';
+  public placement: PopoverPlacement = 'bottom-start';
 
   /**
    * Determines the behavior of the component during scrolling of the parent container.

src/components/popover/popover.ts

@@ -24,7 +24,7 @@ import { styles } from './themes/light/popover.base.css.js';
 /**
  * Describes the preferred placement of a toggle component.
  */
-export type IgcPlacement =
+export type PopoverPlacement =
   | 'top'
   | 'top-start'
   | 'top-end'
@@ -95,7 +95,7 @@ export default class IgcPopoverComponent extends LitElement {
    * Where to place the floating element relative to the parent anchor element.
    */
   @property()
-  public placement: IgcPlacement = 'bottom-start';
+  public placement: PopoverPlacement = 'bottom-start';
 
   /**
    * When enabled the floating element will match the width of its parent anchor element.

src/components/select/select.ts

@@ -49,7 +49,9 @@ import {
 } from '../common/util.js';
 import IgcIconComponent from '../icon/icon.js';
 import IgcInputComponent from '../input/input.js';
-import IgcPopoverComponent, { type IgcPlacement } from '../popover/popover.js';
+import IgcPopoverComponent, {
+  type PopoverPlacement,
+} from '../popover/popover.js';
 import IgcValidationContainerComponent from '../validation-container/validation-container.js';
 import IgcSelectGroupComponent from './select-group.js';
 import IgcSelectHeaderComponent from './select-header.js';
@@ -225,7 +227,7 @@ export default class IgcSelectComponent extends FormAssociatedRequiredMixin(
    * @attr
    */
   @property()
-  public placement: IgcPlacement = 'bottom-start';
+  public placement: PopoverPlacement = 'bottom-start';
 
   /**
    * Determines the behavior of the component during scrolling of the parent container.

src/components/tree/tree-navigation.spec.ts

@@ -4,7 +4,7 @@ import { spy } from 'sinon';
 import { defineComponents } from '../../index.js';
 import IgcTreeItemComponent from './tree-item.js';
 import { SLOTS, TreeTestFunctions, navigationTree } from './tree-utils.spec.js';
-import type { IgcSelectionEventArgs } from './tree.common.js';
+import type { TreeSelectionEventInit } from './tree.common.js';
 import IgcTreeComponent from './tree.js';
 import type { IgcTreeNavigationService } from './tree.navigation.js';
 
@@ -437,7 +437,7 @@ describe('Tree Navigation', () => {
     expect(topLevelItems[0].active).to.be.true;
     expect(topLevelItems[0].selected).to.be.true;
 
-    let args: IgcSelectionEventArgs = {
+    let args: TreeSelectionEventInit = {
       detail: {
         newSelection: [topLevelItems[0]],
       },
@@ -510,7 +510,7 @@ describe('Tree Navigation', () => {
     expect(treeNavService.activeItem).to.equal(topLevelItems[1]);
     expect(treeNavService.focusedItem).to.equal(topLevelItems[1]);
 
-    const args: IgcSelectionEventArgs = {
+    const args: TreeSelectionEventInit = {
       detail: {
         newSelection: [topLevelItems[1]],
       },
@@ -543,7 +543,7 @@ describe('Tree Navigation', () => {
     expect(treeNavService.activeItem).to.equal(topLevelItems[0]);
     expect(treeNavService.focusedItem).to.equal(topLevelItems[0]);
 
-    let args: IgcSelectionEventArgs = {
+    let args: TreeSelectionEventInit = {
       detail: {
         newSelection: [topLevelItems[0]],
       },

src/components/tree/tree-selection.spec.ts

@@ -10,7 +10,7 @@ import {
   selectedItemsTree,
   simpleTree,
 } from './tree-utils.spec.js';
-import type { IgcSelectionEventArgs } from './tree.common.js';
+import type { TreeSelectionEventInit } from './tree.common.js';
 import IgcTreeComponent from './tree.js';
 import type { IgcTreeSelectionService } from './tree.selection.js';
 
@@ -218,7 +218,7 @@ describe('Tree Selection', () => {
       initialSelection.shift();
 
       // Should emit igcSelection event w/ correct args when an item is deselected
-      let args: IgcSelectionEventArgs = {
+      let args: TreeSelectionEventInit = {
         detail: {
           newSelection: initialSelection,
         },
@@ -268,7 +268,7 @@ describe('Tree Selection', () => {
       expect(cb.checked).to.be.false;
       expect(cb.indeterminate).to.be.false;
 
-      const args: IgcSelectionEventArgs = {
+      const args: TreeSelectionEventInit = {
         detail: {
           newSelection: [...initialSelection, item12],
         },
@@ -300,7 +300,7 @@ describe('Tree Selection', () => {
         topLevelItems[1].getChildren()[1],
       ];
 
-      let args: IgcSelectionEventArgs = {
+      let args: TreeSelectionEventInit = {
         detail: {
           newSelection: [topLevelItems[0]],
         },
@@ -362,7 +362,7 @@ describe('Tree Selection', () => {
       tree.deselect();
       await elementUpdated(tree);
 
-      const args: IgcSelectionEventArgs = {
+      const args: TreeSelectionEventInit = {
         detail: {
           newSelection: [topLevelItems[2]],
         },
@@ -707,7 +707,7 @@ describe('Tree Selection', () => {
       expect(cb.checked).to.be.false;
       expect(cb.indeterminate).to.be.false;
 
-      const args: IgcSelectionEventArgs = {
+      const args: TreeSelectionEventInit = {
         detail: {
           newSelection: [...initialSelection, item211],
         },

src/components/tree/tree.common.ts

@@ -1,19 +1,20 @@
+import type { RequiredProps } from '../common/util.js';
 import type IgcTreeItemComponent from './tree-item.js';
 
 export interface IgcTreeComponentEventMap {
   /* alternateName: selectionChanged */
-  igcSelection: CustomEvent<TreeSelectionChange>;
+  igcSelection: CustomEvent<IgcTreeSelectionEventArgs>;
   igcItemExpanding: CustomEvent<IgcTreeItemComponent>;
   igcItemExpanded: CustomEvent<IgcTreeItemComponent>;
   igcItemCollapsing: CustomEvent<IgcTreeItemComponent>;
   igcItemCollapsed: CustomEvent<IgcTreeItemComponent>;
   igcActiveItem: CustomEvent<IgcTreeItemComponent>;
 }
-export interface IgcSelectionEventArgs {
-  detail: TreeSelectionChange;
-  cancelable: boolean;
-}
+export type TreeSelectionEventInit = RequiredProps<
+  CustomEventInit<IgcTreeSelectionEventArgs>,
+  'detail' | 'cancelable'
+>;
 
-export interface TreeSelectionChange {
+export interface IgcTreeSelectionEventArgs {
   newSelection: IgcTreeItemComponent[];
 }

src/components/tree/tree.selection.ts

@@ -1,6 +1,6 @@
 import { isEmpty } from '../common/util.js';
 import type IgcTreeItemComponent from './tree-item.js';
-import type { IgcSelectionEventArgs } from './tree.common.js';
+import type { TreeSelectionEventInit } from './tree.common.js';
 import type IgcTreeComponent from './tree.js';
 
 /* blazorSuppress */
@@ -113,7 +113,7 @@ export class IgcTreeSelectionService {
       return;
     }
 
-    const args: IgcSelectionEventArgs = {
+    const args: TreeSelectionEventInit = {
       detail: {
         newSelection,
       },
@@ -182,7 +182,7 @@ export class IgcTreeSelectionService {
 
     this.calculateItemsNewSelectionState(currSelection, added, removed);
 
-    const args: IgcSelectionEventArgs = {
+    const args: TreeSelectionEventInit = {
       detail: {
         newSelection: Array.from(this.itemsToBeSelected),
       },

src/index.ts

@@ -83,7 +83,10 @@ export {
 export { configureTheme } from './theming/config.js';
 
 // localization objects
-export { IgcCalendarResourceStringEN } from './components/common/i18n/calendar.resources.js';
+export {
+  IgcCalendarResourceStringEN,
+  type IgcCalendarResourceStrings,
+} from './components/common/i18n/calendar.resources.js';
 
 // Event maps
 export type { IgcBannerComponentEventMap } from './components/banner/banner.js';
@@ -131,18 +134,19 @@ export { DateRangeType } from './components/calendar/types.js';
 export type { CheckboxChangeEventArgs } from './components/checkbox/checkbox-base.js';
 export { DatePart } from './components/date-time-input/date-util.js';
 export type { DatePartDeltas } from './components/date-time-input/date-util.js';
+export type { PopoverPlacement } from './components/popover/popover.js';
 export type { RadioChangeEventArgs } from './components/radio/radio.js';
 export type { IgcRangeSliderValue } from './components/slider/range-slider.js';
 export type {
   IgcActiveStepChangingArgs,
   IgcActiveStepChangedArgs,
 } from './components/stepper/stepper.common.js';
+export type { IgcTreeSelectionEventArgs } from './components/tree/tree.common.js';
 export type {
   ComboItemTemplate,
   ComboTemplateProps,
   FilteringOptions,
   GroupingDirection,
-  GroupingOptions,
   IgcComboChangeEventArgs,
 } from './components/combo/types.js';
 export type { IconMeta } from './components/icon/registry/types.js';