igniteui-webcomponents 7.3.0-beta.0 → 7.3.0-beta.1

package/components/tooltip/tooltip.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../../src/components/tooltip/tooltip.ts"],"names":[],"mappings":"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","sourcesContent":["import { html, LitElement, nothing, type PropertyValues } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { createRef, ref } from 'lit/directives/ref.js';\nimport { EaseOut } from '#animations/easings.js';\nimport { addAnimationController } from '#animations/player.js';\nimport { fadeOut } from '#animations/presets/fade/index.js';\nimport { scaleInCenter } from '#animations/presets/scale/index.js';\nimport { addInternalsController } from '#internals/controllers/internals.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { partMap } from '#internals/part-map.js';\nimport { isElement, isLTR } from '#internals/utils/dom.js';\nimport { asNumber } from '#internals/utils/math.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcIconComponent from '../icon/icon.js';\nimport IgcPopoverComponent, {\n  type PopoverPlacement,\n} from '../popover/popover.js';\nimport { addTooltipController } from './controller.js';\nimport { styles as shared } from './themes/shared/tooltip.common.css.js';\nimport { all } from './themes/themes.js';\nimport { styles } from './themes/tooltip.base.css.js';\n\nexport interface IgcTooltipComponentEventMap {\n  igcOpening: CustomEvent<void>;\n  igcOpened: CustomEvent<void>;\n  igcClosing: CustomEvent<void>;\n  igcClosed: CustomEvent<void>;\n}\n\n/** Additional offset applied to the arrow element for aligned placements. */\nconst ARROW_OFFSET = 8;\n\ntype TooltipStateOptions = {\n  show: boolean;\n  withDelay?: boolean;\n  withEvents?: boolean;\n};\n\n/**\n * Provides a way to display supplementary information related to an element when a user interacts with it (e.g., hover, focus).\n * It offers features such as placement customization, delays, sticky mode, and animations.\n *\n * @element igc-tooltip\n *\n * @slot - Default slot of the tooltip component.\n * @slot close-button - Slot for custom sticky-mode close action (e.g., an icon/button).\n *\n * @csspart base - The wrapping container of the tooltip content.\n * @csspart simple-text - The container where the message property of the tooltip is rendered.\n * @csspart close-button - The default sticky-mode close button.\n *\n * @fires igcOpening - Emitted before the tooltip begins to open. Can be canceled to prevent opening.\n * @fires igcOpened - Emitted after the tooltip has successfully opened and is visible.\n * @fires igcClosing - Emitted before the tooltip begins to close. Can be canceled to prevent closing.\n * @fires igcClosed - Emitted after the tooltip has been fully removed from view.\n */\nexport default class IgcTooltipComponent extends EventEmitterMixin<\n  IgcTooltipComponentEventMap,\n  Constructor<LitElement>\n>(LitElement) {\n  public static readonly tagName = 'igc-tooltip';\n  public static styles = [styles, shared];\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(\n      IgcTooltipComponent,\n      IgcPopoverComponent,\n      IgcIconComponent\n    );\n  }\n\n  private readonly _internals = addInternalsController(this, {\n    initialARIA: {\n      role: 'tooltip',\n      ariaAtomic: 'true',\n      ariaLive: 'polite',\n    },\n  });\n\n  private readonly _controller = addTooltipController(this, {\n    onShow: () => this._showOnInteraction(),\n    onHide: () => this._hideOnInteraction(),\n    onEscape: () => this._hideOnEscape(),\n    onClick: () => this._cancelTransition(),\n    // The controller dropped the anchor the tooltip is bound to.\n    onReset: () => this._cancelTransition(false),\n  });\n\n  private readonly _containerRef = createRef<HTMLElement>();\n  private readonly _player = addAnimationController(this, this._containerRef);\n  private readonly _slots = addSlotController(this, {\n    slots: setSlots('close-button'),\n  });\n\n  private readonly _showAnimation = scaleInCenter({\n    duration: 150,\n    easing: EaseOut.Quad,\n  });\n\n  private readonly _hideAnimation = fadeOut({\n    duration: 75,\n    easing: EaseOut.Sine,\n  });\n\n  /** The queued, not yet committed transition, if a delay is in effect. */\n  private _pending?: {\n    timer: ReturnType<typeof setTimeout>;\n    resolve: (value: boolean) => void;\n  };\n\n  /** A commit that finishes with a stale id has been superseded. */\n  private _transitionId = 0;\n\n  private _animating = false;\n\n  /**\n   * The state the tooltip is heading to. A show commits `open` upfront so the\n   * popover renders; a hide commits it only once its animation is done.\n   */\n  private _requestedState = false;\n\n  private _showDelay = 200;\n  private _hideDelay = 300;\n\n  @query('igc-popover', true)\n  private readonly _popover!: IgcPopoverComponent;\n\n  @query('#arrow')\n  private readonly _arrowElement!: HTMLElement;\n\n  private get _arrowOffset(): number {\n    const [side, alignment] = this.placement.split('-');\n\n    if (!alignment) {\n      return 0;\n    }\n\n    const offset = alignment === 'start' ? -ARROW_OFFSET : ARROW_OFFSET;\n    const isHorizontal = side === 'left' || side === 'right';\n\n    // Only the vertical placements follow the writing direction.\n    return isHorizontal || isLTR(this) ? offset : -offset;\n  }\n\n  /**\n   * Whether the consumer projected anything into the default slot. Queried\n   * without flattening, which would report the rendered `message` - the slot's\n   * own fallback content - as if it came from the consumer.\n   */\n  private get _hasProjectedContent(): boolean {\n    return this._slots\n      .getAssignedNodes('[default]')\n      .some(\n        (node) =>\n          isElement(node) ||\n          (node.nodeType === Node.TEXT_NODE &&\n            Boolean(node.textContent?.trim()))\n      );\n  }\n\n  /**\n   * Whether the tooltip is showing.\n   *\n   * @attr open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public set open(value: boolean) {\n    this._requestedState = value;\n    this._controller.open = value;\n  }\n\n  public get open(): boolean {\n    return this._controller.open;\n  }\n\n  /**\n   * Whether to render an arrow indicator for the tooltip.\n   *\n   * @attr with-arrow\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'with-arrow' })\n  public withArrow = false;\n\n  /**\n   * The offset of the tooltip from the anchor in pixels.\n   *\n   * @attr offset\n   * @default 6\n   */\n  @property({ type: Number })\n  public offset = 6;\n\n  /**\n   * Where to place the tooltip relative to its anchor element.\n   *\n   * @attr placement\n   * @default bottom\n   */\n  @property()\n  public placement: PopoverPlacement = 'bottom';\n\n  /**\n   * An element instance or an IDREF to use as the anchor for the tooltip.\n   *\n   * @remarks\n   * Trying to bind to an IDREF that does not exist in the current DOM root will not work.\n   * In such scenarios, it is better to get a DOM reference and pass it to the tooltip instance.\n   *\n   * @attr anchor\n   */\n  @property()\n  public anchor?: Element | string;\n\n  /**\n   * Which event triggers will show the tooltip.\n   * Expects a comma separated string of different event triggers.\n   *\n   * @attr show-triggers\n   * @default pointerenter,focusin\n   */\n  @property({ attribute: 'show-triggers' })\n  public set showTriggers(value: string) {\n    this._controller.showTriggers = value;\n  }\n\n  public get showTriggers(): string {\n    return this._controller.showTriggers;\n  }\n\n  /**\n   * Which event triggers will hide the tooltip.\n   * Expects a comma separated string of different event triggers.\n   *\n   * @attr hide-triggers\n   * @default pointerleave,click,focusout\n   */\n  @property({ attribute: 'hide-triggers' })\n  public set hideTriggers(value: string) {\n    this._controller.hideTriggers = value;\n  }\n\n  public get hideTriggers(): string {\n    return this._controller.hideTriggers;\n  }\n\n  /**\n   * Specifies the number of milliseconds that should pass before showing the tooltip.\n   *\n   * @attr show-delay\n   * @default 200\n   */\n  @property({ attribute: 'show-delay', type: Number })\n  public set showDelay(value: number) {\n    this._showDelay = Math.max(0, asNumber(value));\n  }\n\n  public get showDelay(): number {\n    return this._showDelay;\n  }\n\n  /**\n   * Specifies the number of milliseconds that should pass before hiding the tooltip.\n   *\n   * @attr hide-delay\n   * @default 300\n   */\n  @property({ attribute: 'hide-delay', type: Number })\n  public set hideDelay(value: number) {\n    this._hideDelay = Math.max(0, asNumber(value));\n  }\n\n  public get hideDelay(): number {\n    return this._hideDelay;\n  }\n\n  /**\n   * Specifies plain text as the tooltip content.\n   *\n   * @attr message\n   */\n  @property()\n  public message = '';\n\n  /**\n   * Specifies if the tooltip remains visible until the user closes it via the close button or Esc key.\n   *\n   * @attr sticky\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public sticky = false;\n\n  constructor() {\n    super();\n    addThemingController(this, all);\n  }\n\n  protected override firstUpdated(): void {\n    if (this.open) {\n      this.updateComplete.then(() => {\n        this._player.playExclusive(this._showAnimation);\n      });\n    }\n  }\n\n  protected override updated(changedProperties: PropertyValues<this>): void {\n    // The arrow is created by the render that just committed, so the popover\n    // can only be handed it afterwards.\n    if (changedProperties.has('withArrow')) {\n      this._popover.arrow = this.withArrow ? this._arrowElement : null;\n    }\n  }\n\n  protected override willUpdate(changedProperties: PropertyValues<this>): void {\n    if (changedProperties.has('anchor')) {\n      this._controller.resolveAnchor(this.anchor);\n    }\n\n    if (changedProperties.has('sticky')) {\n      this._internals.setARIA({ role: this.sticky ? 'status' : 'tooltip' });\n    }\n  }\n\n  private _emitEvent(name: keyof IgcTooltipComponentEventMap): boolean {\n    return this.emitEvent(name, {\n      cancelable: name === 'igcOpening' || name === 'igcClosing',\n    });\n  }\n\n  /**\n   * Invalidates the queued and/or running transition, resolving a delayed one\n   * with `false`. The caller must settle the state it left behind.\n   *\n   * @returns Whether the aborted transition was mid-animation.\n   */\n  private _abortTransition(): boolean {\n    const wasAnimating = this._animating;\n\n    this._transitionId++;\n    this._animating = false;\n\n    clearTimeout(this._pending?.timer);\n    this._pending?.resolve(false);\n    this._pending = undefined;\n\n    return wasAnimating;\n  }\n\n  /** Lands the tooltip on `state` after its transition was aborted. */\n  private _settleState(state: boolean, wasAnimating: boolean): void {\n    this._requestedState = state;\n\n    if (wasAnimating) {\n      this._player.cancelAll();\n      this.inert = false;\n    }\n\n    // Via the accessor - it drives the reflection and the render.\n    if (this.open !== state) {\n      this.open = state;\n    }\n  }\n\n  /**\n   * Drops a queued or running transition and settles on `state`, by default\n   * the state the tooltip is already committed to.\n   */\n  private _cancelTransition(state = this.open): void {\n    this._settleState(state, this._abortTransition());\n  }\n\n  private async _applyTooltipState({\n    show,\n    withDelay = false,\n    withEvents = false,\n  }: TooltipStateOptions): Promise<boolean> {\n    if (show === this._requestedState) {\n      return false;\n    }\n\n    // Supersede whatever transition is queued or already running.\n    const wasAnimating = this._abortTransition();\n    this._requestedState = show;\n\n    // A superseded transition that never animated leaves the tooltip already\n    // in the requested state.\n    if (show === this.open && !wasAnimating) {\n      return false;\n    }\n\n    // Vetoed - the first guard proves we were at `!show`.\n    if (withEvents && !this._emitEvent(show ? 'igcOpening' : 'igcClosing')) {\n      this._settleState(!show, wasAnimating);\n      return false;\n    }\n\n    const id = this._transitionId;\n\n    const commitStateChange = async () => {\n      if (show) {\n        this.open = true;\n      }\n\n      // Make the tooltip ignore most interactions while the animation\n      // is running. In the rare case when the popover overlaps its anchor\n      // this will prevent looping between the anchor and tooltip handlers.\n      this.inert = true;\n      this._animating = true;\n\n      const animationComplete = await this._player.playExclusive(\n        show ? this._showAnimation : this._hideAnimation\n      );\n\n      // Superseded while animating - the newer transition owns the state now.\n      if (id !== this._transitionId) {\n        return false;\n      }\n\n      this._animating = false;\n      this.inert = false;\n      this.open = show;\n\n      if (animationComplete && withEvents) {\n        this._emitEvent(show ? 'igcOpened' : 'igcClosed');\n      }\n\n      return animationComplete;\n    };\n\n    if (!withDelay) {\n      return commitStateChange();\n    }\n\n    return new Promise<boolean>((resolve) => {\n      const timer = setTimeout(\n        () => {\n          this._pending = undefined;\n          commitStateChange().then(resolve);\n        },\n        show ? this.showDelay : this.hideDelay\n      );\n\n      this._pending = { timer, resolve };\n    });\n  }\n\n  /**\n   * Shows the tooltip if not already showing.\n   * If a target is provided, sets it as a transient anchor.\n   *\n   * @remarks\n   * Bypasses `showDelay` and does not emit `igcOpening`/`igcOpened`.\n   * Resolves with whether the tooltip transitioned to a shown state.\n   */\n  public async show(target?: Element | string): Promise<boolean> {\n    if (target) {\n      this._cancelTransition();\n      this._controller.setAnchor(target, true);\n    }\n\n    return await this._applyTooltipState({ show: true });\n  }\n\n  /**\n   * Hides the tooltip if not already hidden.\n   *\n   * @remarks\n   * Bypasses `hideDelay` and does not emit `igcClosing`/`igcClosed`.\n   * Resolves with whether the tooltip transitioned to a hidden state.\n   */\n  public async hide(): Promise<boolean> {\n    return await this._applyTooltipState({ show: false });\n  }\n\n  /**\n   * Toggles the tooltip between shown/hidden state.\n   *\n   * @remarks\n   * Resolves with whether the tooltip transitioned to the opposite state.\n   */\n  public async toggle(): Promise<boolean> {\n    return await (this.open ? this.hide() : this.show());\n  }\n\n  protected _showWithEvent(): Promise<boolean> {\n    return this._applyTooltipState({\n      show: true,\n      withDelay: true,\n      withEvents: true,\n    });\n  }\n\n  protected _hideWithEvent(): Promise<boolean> {\n    return this._applyTooltipState({\n      show: false,\n      withDelay: true,\n      withEvents: true,\n    });\n  }\n\n  private _showOnInteraction(): void {\n    this._cancelTransition();\n    this._showWithEvent();\n  }\n\n  private _hideOnInteraction(): void {\n    if (!this.sticky) {\n      this._hideWithEvent();\n    }\n  }\n\n  /** Sticky mode close action - closes without waiting out `hideDelay`. */\n  private _hideOnCloseClick(): void {\n    this._applyTooltipState({ show: false, withEvents: true });\n  }\n\n  private async _hideOnEscape(): Promise<void> {\n    // `hide()` is silent, so announce the close here - if there was one.\n    if (await this.hide()) {\n      this._emitEvent('igcClosed');\n    }\n  }\n\n  protected override render() {\n    const parts = {\n      base: true,\n      'simple-text': !this._hasProjectedContent,\n    };\n\n    return html`\n      <igc-popover\n        .inert=${!this.open}\n        .placement=${this.placement}\n        .offset=${this.offset}\n        .anchor=${this._controller.anchor ?? undefined}\n        .arrowOffset=${this._arrowOffset}\n        .shiftPadding=${8}\n        ?open=${this.open}\n        flip\n        shift\n      >\n        <div ${ref(this._containerRef)} part=${partMap(parts)}>\n          <slot>${this.message}</slot>\n          ${\n            this.sticky\n              ? html`\n                  <slot name=\"close-button\" @click=${this._hideOnCloseClick}>\n                    <button\n                      type=\"button\"\n                      part=\"close-button\"\n                      aria-label=\"Close\"\n                    >\n                      <igc-icon\n                        name=\"input_clear\"\n                        collection=\"default\"\n                        aria-hidden=\"true\"\n                      ></igc-icon>\n                    </button>\n                  </slot>\n                `\n              : nothing\n          }\n          ${this.withArrow ? html`<div id=\"arrow\"></div>` : nothing}\n        </div>\n      </igc-popover>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-tooltip': IgcTooltipComponent;\n  }\n}\n"]}
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../../src/components/tooltip/tooltip.ts"],"names":[],"mappings":"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","sourcesContent":["import { html, LitElement, nothing, type PropertyValues } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { createRef, ref } from 'lit/directives/ref.js';\nimport { EaseOut } from '#animations/easings.js';\nimport { addAnimationController } from '#animations/player.js';\nimport { fadeOut } from '#animations/presets/fade/index.js';\nimport { scaleInCenter } from '#animations/presets/scale/index.js';\nimport { addInternalsController } from '#internals/controllers/internals.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport {\n  coercedProperty,\n  type CoercedPropertyConfig,\n} from '#internals/decorators/coerced-property.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { partMap } from '#internals/part-map.js';\nimport { isElement, isLTR } from '#internals/utils/dom.js';\nimport { asNumber } from '#internals/utils/math.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcIconComponent from '../icon/icon.js';\nimport IgcPopoverComponent, {\n  type PopoverPlacement,\n} from '../popover/popover.js';\nimport { addTooltipController } from './controller.js';\nimport { styles as shared } from './themes/shared/tooltip.common.css.js';\nimport { all } from './themes/themes.js';\nimport { styles } from './themes/tooltip.base.css.js';\n\nexport interface IgcTooltipComponentEventMap {\n  igcOpening: CustomEvent<void>;\n  igcOpened: CustomEvent<void>;\n  igcClosing: CustomEvent<void>;\n  igcClosed: CustomEvent<void>;\n}\n\n/** Additional offset applied to the arrow element for aligned placements. */\nconst ARROW_OFFSET = 8;\n\ntype TooltipStateOptions = {\n  show: boolean;\n  withDelay?: boolean;\n  withEvents?: boolean;\n};\n\n/**\n * Provides a way to display supplementary information related to an element when a user interacts with it (e.g., hover, focus).\n * It offers features such as placement customization, delays, sticky mode, and animations.\n *\n * @element igc-tooltip\n *\n * @slot - Default slot of the tooltip component.\n * @slot close-button - Slot for custom sticky-mode close action (e.g., an icon/button).\n *\n * @csspart base - The wrapping container of the tooltip content.\n * @csspart simple-text - The container where the message property of the tooltip is rendered.\n * @csspart close-button - The default sticky-mode close button.\n *\n * @fires igcOpening - Emitted before the tooltip begins to open. Can be canceled to prevent opening.\n * @fires igcOpened - Emitted after the tooltip has successfully opened and is visible.\n * @fires igcClosing - Emitted before the tooltip begins to close. Can be canceled to prevent closing.\n * @fires igcClosed - Emitted after the tooltip has been fully removed from view.\n */\nexport default class IgcTooltipComponent extends EventEmitterMixin<\n  IgcTooltipComponentEventMap,\n  Constructor<LitElement>\n>(LitElement) {\n  public static readonly tagName = 'igc-tooltip';\n  public static styles = [styles, shared];\n\n  /** Shared config for the delay properties - a negative delay is no delay. */\n  private static readonly _delay: CoercedPropertyConfig<\n    number,\n    IgcTooltipComponent\n  > = {\n    transform: ({ value }) => Math.max(0, asNumber(value)),\n  };\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(\n      IgcTooltipComponent,\n      IgcPopoverComponent,\n      IgcIconComponent\n    );\n  }\n\n  private readonly _controller = addTooltipController(this, {\n    onShow: () => this._showOnInteraction(),\n    onHide: () => this._hideOnInteraction(),\n    onEscape: () => this._hideOnEscape(),\n    onClick: () => this._cancelTransition(),\n    // The controller dropped the anchor the tooltip is bound to.\n    onReset: () => this._cancelTransition(false),\n  });\n\n  private readonly _containerRef = createRef<HTMLElement>();\n  private readonly _player = addAnimationController(this, this._containerRef);\n  private readonly _slots = addSlotController(this, {\n    slots: setSlots('close-button'),\n  });\n\n  private readonly _showAnimation = scaleInCenter({\n    duration: 150,\n    easing: EaseOut.Quad,\n  });\n\n  private readonly _hideAnimation = fadeOut({\n    duration: 75,\n    easing: EaseOut.Sine,\n  });\n\n  /** The queued, not yet committed transition, if a delay is in effect. */\n  private _pending?: {\n    timer: ReturnType<typeof setTimeout>;\n    resolve: (value: boolean) => void;\n  };\n\n  /** A commit that finishes with a stale id has been superseded. */\n  private _transitionId = 0;\n\n  private _animating = false;\n\n  /**\n   * The state the tooltip is heading to. A show commits `open` upfront so the\n   * popover renders; a hide commits it only once its animation is done.\n   */\n  private _requestedState = false;\n\n  @query('igc-popover', true)\n  private readonly _popover!: IgcPopoverComponent;\n\n  @query('#arrow')\n  private readonly _arrowElement!: HTMLElement;\n\n  private get _arrowOffset(): number {\n    const [side, alignment] = this.placement.split('-');\n\n    if (!alignment) {\n      return 0;\n    }\n\n    const offset = alignment === 'start' ? -ARROW_OFFSET : ARROW_OFFSET;\n    const isHorizontal = side === 'left' || side === 'right';\n\n    // Only the vertical placements follow the writing direction.\n    return isHorizontal || isLTR(this) ? offset : -offset;\n  }\n\n  /**\n   * Whether the consumer projected anything into the default slot. Queried\n   * without flattening, which would report the rendered `message` - the slot's\n   * own fallback content - as if it came from the consumer.\n   */\n  private get _hasProjectedContent(): boolean {\n    return this._slots\n      .getAssignedNodes('[default]')\n      .some(\n        (node) =>\n          isElement(node) ||\n          (node.nodeType === Node.TEXT_NODE &&\n            Boolean(node.textContent?.trim()))\n      );\n  }\n\n  /**\n   * Whether the tooltip is showing.\n   *\n   * @attr open\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public set open(value: boolean) {\n    this._requestedState = value;\n    this._controller.open = value;\n  }\n\n  public get open(): boolean {\n    return this._controller.open;\n  }\n\n  /**\n   * Whether to render an arrow indicator for the tooltip.\n   *\n   * @attr with-arrow\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'with-arrow' })\n  public withArrow = false;\n\n  /**\n   * The offset of the tooltip from the anchor in pixels.\n   *\n   * @attr offset\n   * @default 6\n   */\n  @property({ type: Number })\n  public offset = 6;\n\n  /**\n   * Where to place the tooltip relative to its anchor element.\n   *\n   * @attr placement\n   * @default bottom\n   */\n  @property()\n  public placement: PopoverPlacement = 'bottom';\n\n  /**\n   * An element instance or an IDREF to use as the anchor for the tooltip.\n   *\n   * @remarks\n   * Trying to bind to an IDREF that does not exist in the current DOM root will not work.\n   * In such scenarios, it is better to get a DOM reference and pass it to the tooltip instance.\n   *\n   * @attr anchor\n   */\n  @property()\n  public anchor?: Element | string;\n\n  /**\n   * Which event triggers will show the tooltip.\n   * Expects a comma separated string of different event triggers.\n   *\n   * @attr show-triggers\n   * @default pointerenter,focusin\n   */\n  @property({ attribute: 'show-triggers' })\n  public set showTriggers(value: string) {\n    this._controller.showTriggers = value;\n  }\n\n  public get showTriggers(): string {\n    return this._controller.showTriggers;\n  }\n\n  /**\n   * Which event triggers will hide the tooltip.\n   * Expects a comma separated string of different event triggers.\n   *\n   * @attr hide-triggers\n   * @default pointerleave,click,focusout\n   */\n  @property({ attribute: 'hide-triggers' })\n  public set hideTriggers(value: string) {\n    this._controller.hideTriggers = value;\n  }\n\n  public get hideTriggers(): string {\n    return this._controller.hideTriggers;\n  }\n\n  /**\n   * Specifies the number of milliseconds that should pass before showing the tooltip.\n   *\n   * @attr show-delay\n   * @default 200\n   */\n  @property({ attribute: 'show-delay', type: Number })\n  @coercedProperty(IgcTooltipComponent._delay)\n  public showDelay = 200;\n\n  /**\n   * Specifies the number of milliseconds that should pass before hiding the tooltip.\n   *\n   * @attr hide-delay\n   * @default 300\n   */\n  @property({ attribute: 'hide-delay', type: Number })\n  @coercedProperty(IgcTooltipComponent._delay)\n  public hideDelay = 300;\n\n  /**\n   * Specifies plain text as the tooltip content.\n   *\n   * @attr message\n   */\n  @property()\n  public message = '';\n\n  /**\n   * Specifies if the tooltip remains visible until the user closes it via the close button or Esc key.\n   *\n   * @attr sticky\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public sticky = false;\n\n  constructor() {\n    super();\n    addThemingController(this, all);\n\n    addInternalsController(this, {\n      initialARIA: {\n        role: 'tooltip',\n        ariaAtomic: 'true',\n        ariaLive: 'polite',\n      },\n      aria: () => ({ role: this.sticky ? 'status' : 'tooltip' }),\n    });\n  }\n\n  protected override firstUpdated(): void {\n    if (this.open) {\n      this.updateComplete.then(() => {\n        this._player.playExclusive(this._showAnimation);\n      });\n    }\n  }\n\n  protected override updated(changedProperties: PropertyValues<this>): void {\n    // The arrow is created by the render that just committed, so the popover\n    // can only be handed it afterwards.\n    if (changedProperties.has('withArrow')) {\n      this._popover.arrow = this.withArrow ? this._arrowElement : null;\n    }\n  }\n\n  protected override willUpdate(changedProperties: PropertyValues<this>): void {\n    if (changedProperties.has('anchor')) {\n      this._controller.resolveAnchor(this.anchor);\n    }\n  }\n\n  private _emitEvent(name: keyof IgcTooltipComponentEventMap): boolean {\n    return this.emitEvent(name, {\n      cancelable: name === 'igcOpening' || name === 'igcClosing',\n    });\n  }\n\n  /**\n   * Invalidates the queued and/or running transition, resolving a delayed one\n   * with `false`. The caller must settle the state it left behind.\n   *\n   * @returns Whether the aborted transition was mid-animation.\n   */\n  private _abortTransition(): boolean {\n    const wasAnimating = this._animating;\n\n    this._transitionId++;\n    this._animating = false;\n\n    clearTimeout(this._pending?.timer);\n    this._pending?.resolve(false);\n    this._pending = undefined;\n\n    return wasAnimating;\n  }\n\n  /** Lands the tooltip on `state` after its transition was aborted. */\n  private _settleState(state: boolean, wasAnimating: boolean): void {\n    this._requestedState = state;\n\n    if (wasAnimating) {\n      this._player.cancelAll();\n      this.inert = false;\n    }\n\n    // Via the accessor - it drives the reflection and the render.\n    if (this.open !== state) {\n      this.open = state;\n    }\n  }\n\n  /**\n   * Drops a queued or running transition and settles on `state`, by default\n   * the state the tooltip is already committed to.\n   */\n  private _cancelTransition(state = this.open): void {\n    this._settleState(state, this._abortTransition());\n  }\n\n  private async _applyTooltipState({\n    show,\n    withDelay = false,\n    withEvents = false,\n  }: TooltipStateOptions): Promise<boolean> {\n    if (show === this._requestedState) {\n      return false;\n    }\n\n    // Supersede whatever transition is queued or already running.\n    const wasAnimating = this._abortTransition();\n    this._requestedState = show;\n\n    // A superseded transition that never animated leaves the tooltip already\n    // in the requested state.\n    if (show === this.open && !wasAnimating) {\n      return false;\n    }\n\n    // Vetoed - the first guard proves we were at `!show`.\n    if (withEvents && !this._emitEvent(show ? 'igcOpening' : 'igcClosing')) {\n      this._settleState(!show, wasAnimating);\n      return false;\n    }\n\n    const id = this._transitionId;\n\n    const commitStateChange = async () => {\n      if (show) {\n        this.open = true;\n      }\n\n      // Make the tooltip ignore most interactions while the animation\n      // is running. In the rare case when the popover overlaps its anchor\n      // this will prevent looping between the anchor and tooltip handlers.\n      this.inert = true;\n      this._animating = true;\n\n      const animationComplete = await this._player.playExclusive(\n        show ? this._showAnimation : this._hideAnimation\n      );\n\n      // Superseded while animating - the newer transition owns the state now.\n      if (id !== this._transitionId) {\n        return false;\n      }\n\n      this._animating = false;\n      this.inert = false;\n      this.open = show;\n\n      if (animationComplete && withEvents) {\n        this._emitEvent(show ? 'igcOpened' : 'igcClosed');\n      }\n\n      return animationComplete;\n    };\n\n    if (!withDelay) {\n      return commitStateChange();\n    }\n\n    return new Promise<boolean>((resolve) => {\n      const timer = setTimeout(\n        () => {\n          this._pending = undefined;\n          commitStateChange().then(resolve);\n        },\n        show ? this.showDelay : this.hideDelay\n      );\n\n      this._pending = { timer, resolve };\n    });\n  }\n\n  /**\n   * Shows the tooltip if not already showing.\n   * If a target is provided, sets it as a transient anchor.\n   *\n   * @remarks\n   * Bypasses `showDelay` and does not emit `igcOpening`/`igcOpened`.\n   * Resolves with whether the tooltip transitioned to a shown state.\n   */\n  public async show(target?: Element | string): Promise<boolean> {\n    if (target) {\n      this._cancelTransition();\n      this._controller.setAnchor(target, true);\n    }\n\n    return await this._applyTooltipState({ show: true });\n  }\n\n  /**\n   * Hides the tooltip if not already hidden.\n   *\n   * @remarks\n   * Bypasses `hideDelay` and does not emit `igcClosing`/`igcClosed`.\n   * Resolves with whether the tooltip transitioned to a hidden state.\n   */\n  public async hide(): Promise<boolean> {\n    return await this._applyTooltipState({ show: false });\n  }\n\n  /**\n   * Toggles the tooltip between shown/hidden state.\n   *\n   * @remarks\n   * Resolves with whether the tooltip transitioned to the opposite state.\n   */\n  public async toggle(): Promise<boolean> {\n    return await (this.open ? this.hide() : this.show());\n  }\n\n  protected _showWithEvent(): Promise<boolean> {\n    return this._applyTooltipState({\n      show: true,\n      withDelay: true,\n      withEvents: true,\n    });\n  }\n\n  protected _hideWithEvent(): Promise<boolean> {\n    return this._applyTooltipState({\n      show: false,\n      withDelay: true,\n      withEvents: true,\n    });\n  }\n\n  private _showOnInteraction(): void {\n    this._cancelTransition();\n    this._showWithEvent();\n  }\n\n  private _hideOnInteraction(): void {\n    if (!this.sticky) {\n      this._hideWithEvent();\n    }\n  }\n\n  /** Sticky mode close action - closes without waiting out `hideDelay`. */\n  private _hideOnCloseClick(): void {\n    this._applyTooltipState({ show: false, withEvents: true });\n  }\n\n  private async _hideOnEscape(): Promise<void> {\n    // `hide()` is silent, so announce the close here - if there was one.\n    if (await this.hide()) {\n      this._emitEvent('igcClosed');\n    }\n  }\n\n  protected override render() {\n    const parts = {\n      base: true,\n      'simple-text': !this._hasProjectedContent,\n    };\n\n    return html`\n      <igc-popover\n        .inert=${!this.open}\n        .placement=${this.placement}\n        .offset=${this.offset}\n        .anchor=${this._controller.anchor ?? undefined}\n        .arrowOffset=${this._arrowOffset}\n        .shiftPadding=${8}\n        ?open=${this.open}\n        flip\n        shift\n      >\n        <div ${ref(this._containerRef)} part=${partMap(parts)}>\n          <slot>${this.message}</slot>\n          ${\n            this.sticky\n              ? html`\n                  <slot name=\"close-button\" @click=${this._hideOnCloseClick}>\n                    <button\n                      type=\"button\"\n                      part=\"close-button\"\n                      aria-label=\"Close\"\n                    >\n                      <igc-icon\n                        name=\"input_clear\"\n                        collection=\"default\"\n                        aria-hidden=\"true\"\n                      ></igc-icon>\n                    </button>\n                  </slot>\n                `\n              : nothing\n          }\n          ${this.withArrow ? html`<div id=\"arrow\"></div>` : nothing}\n        </div>\n      </igc-popover>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-tooltip': IgcTooltipComponent;\n  }\n}\n"]}

package/components/tree/tree.d.ts

@@ -6,7 +6,7 @@ import IgcTreeItemComponent from './tree-item.js';
 import { type IgcTreeComponentEventMap } from './tree.common.js';
 import { IgcTreeNavigationService } from './tree.navigation.js';
 import { IgcTreeSelectionService } from './tree.selection.js';
-declare const IgcTreeComponent_base: Constructor<import("#internals/mixins/event-emitter.js").EventEmitterInterface<IgcTreeComponentEventMap>> & Constructor<LitElement>;
+declare const IgcTreeComponent_base: import("#internals/mixins/constructor.js").AbstractConstructor<import("#internals/mixins/i18n.js").I18nInterface<ITreeResourceStrings, Required<ITreeResourceStrings>>> & Constructor<import("#internals/mixins/event-emitter.js").EventEmitterInterface<IgcTreeComponentEventMap>> & Constructor<LitElement>;
 /**
  * The tree allows users to represent hierarchical data in a tree-view structure,
  * maintaining parent-child relationships, as well as to define static tree-view structure without a corresponding data model.
@@ -26,7 +26,6 @@ export default class IgcTreeComponent extends IgcTreeComponent_base {
     static readonly tagName = "igc-tree";
     static styles: import("lit").CSSResult;
     static register(): void;
-    private readonly _i18nController;
     /** @hidden @internal */
     selectionService: IgcTreeSelectionService;
     /** @hidden @internal */
@@ -46,18 +45,6 @@ export default class IgcTreeComponent extends IgcTreeComponent_base {
      * @attr
      */
     selection: TreeSelection;
-    /**
-     * Gets/Sets the locale used for getting language, affecting resource strings.
-     * @attr locale
-     */
-    set locale(value: string);
-    get locale(): string;
-    /**
-     * The resource strings for localization.
-     * Currently only aria-labels of the default expand/collapse icons are localized for the tree item.
-     */
-    set resourceStrings(value: ITreeResourceStrings);
-    get resourceStrings(): ITreeResourceStrings;
     /**
      * @hidden @internal
      * The tree's top-most items, i.e. its direct `igc-tree-item` light-DOM children.

package/components/tree/tree.js

@@ -10,8 +10,8 @@ import { html, LitElement } from 'lit';
 import { property } from 'lit/decorators.js';
 import { blazorAdditionalDependencies } from '#internals/decorators/blazorAdditionalDependencies.js';
 import { registerComponent } from '#internals/definitions/register.js';
-import { addI18nController } from '#internals/i18n/i18n-controller.js';
 import { EventEmitterMixin } from '#internals/mixins/event-emitter.js';
+import { I18nMixin } from '#internals/mixins/i18n.js';
 import { addThemingController } from '#theming/theming-controller.js';
 import { styles } from './themes/container.base.css.js';
 import { all } from './themes/container.js';
@@ -20,25 +20,16 @@ import { getTreeItemChildren, setAriaState, } from './tree.common.js';
 import { IgcTreeNavigationService } from './tree.navigation.js';
 import { IgcTreeSelectionService } from './tree.selection.js';
 const ITEM_RENDER_DEPENDENCIES = ['selection', 'resourceStrings'];
-let IgcTreeComponent = class IgcTreeComponent extends EventEmitterMixin(LitElement) {
+const i18n = {
+    defaultEN: TreeResourceStringsEN,
+};
+let IgcTreeComponent = class IgcTreeComponent extends I18nMixin(EventEmitterMixin(LitElement), i18n) {
     static { IgcTreeComponent_1 = this; }
     static { this.tagName = 'igc-tree'; }
     static { this.styles = styles; }
     static register() {
         registerComponent(IgcTreeComponent_1, IgcTreeItemComponent);
     }
-    set locale(value) {
-        this._i18nController.locale = value;
-    }
-    get locale() {
-        return this._i18nController.locale;
-    }
-    set resourceStrings(value) {
-        this._i18nController.resourceStrings = value;
-    }
-    get resourceStrings() {
-        return this._i18nController.resourceStrings;
-    }
     get _rootItems() {
         return getTreeItemChildren(this);
     }
@@ -52,9 +43,6 @@ let IgcTreeComponent = class IgcTreeComponent extends EventEmitterMixin(LitEleme
     }
     constructor() {
         super();
-        this._i18nController = addI18nController(this, {
-            defaultEN: TreeResourceStringsEN,
-        });
         this.singleBranchExpand = false;
         this.toggleNodeOnClick = false;
         this.selection = 'none';
@@ -147,12 +135,6 @@ __decorate([
 __decorate([
     property({ reflect: true })
 ], IgcTreeComponent.prototype, "selection", void 0);
-__decorate([
-    property()
-], IgcTreeComponent.prototype, "locale", null);
-__decorate([
-    property({ attribute: false })
-], IgcTreeComponent.prototype, "resourceStrings", null);
 IgcTreeComponent = IgcTreeComponent_1 = __decorate([
     blazorAdditionalDependencies('IgcTreeItemComponent')
 ], IgcTreeComponent);

package/components/tree/tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/components/tree/tree.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type ITreeResourceStrings,\n  TreeResourceStringsEN,\n} from 'igniteui-i18n-core';\nimport { html, LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { blazorAdditionalDependencies } from '#internals/decorators/blazorAdditionalDependencies.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport { addI18nController } from '#internals/i18n/i18n-controller.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport type { TreeSelection } from '../types.js';\nimport { styles } from './themes/container.base.css.js';\nimport { all } from './themes/container.js';\nimport IgcTreeItemComponent from './tree-item.js';\nimport {\n  getTreeItemChildren,\n  type IgcTreeComponentEventMap,\n  setAriaState,\n} from './tree.common.js';\nimport { IgcTreeNavigationService } from './tree.navigation.js';\nimport { IgcTreeSelectionService } from './tree.selection.js';\n\n/**\n * Tree properties that items read while rendering. The tree is not a reactive\n * source for them, so changing one has to re-render the items by hand or they\n * keep rendering stale output.\n *\n * Prefer reading tree state at event time over extending this - a handler\n * always sees the current value and costs no re-render. Direction is handled in\n * CSS via `:dir()` for the same reason.\n */\nconst ITEM_RENDER_DEPENDENCIES = ['selection', 'resourceStrings'] as const;\n\n/**\n * The tree allows users to represent hierarchical data in a tree-view structure,\n * maintaining parent-child relationships, as well as to define static tree-view structure without a corresponding data model.\n *\n * @element igc-tree\n *\n * @slot - Renders the tree items inside default slot.\n *\n * @fires igcSelection - Emitted when item selection is changing, before the selection completes.\n * @fires igcItemCollapsed - Emitted when tree item is collapsed.\n * @fires igcItemCollapsing - Emitted when tree item is about to collapse.\n * @fires igcItemExpanded - Emitted when tree item is expanded.\n * @fires igcItemExpanding - Emitted when tree item is about to expand.\n * @fires igcActiveItem - Emitted when the tree's `active` item changes.\n */\n@blazorAdditionalDependencies('IgcTreeItemComponent')\nexport default class IgcTreeComponent extends EventEmitterMixin<\n  IgcTreeComponentEventMap,\n  Constructor<LitElement>\n>(LitElement) {\n  public static readonly tagName = 'igc-tree';\n  public static styles = styles;\n\n  /* blazorSuppress */\n  public static register() {\n    registerComponent(IgcTreeComponent, IgcTreeItemComponent);\n  }\n\n  private readonly _i18nController = addI18nController<ITreeResourceStrings>(\n    this,\n    {\n      defaultEN: TreeResourceStringsEN,\n    }\n  );\n\n  /** @hidden @internal */\n  public selectionService!: IgcTreeSelectionService;\n\n  /** @hidden @internal */\n  public navService!: IgcTreeNavigationService;\n\n  /**\n   * Whether a single or multiple of a parent's child items can be expanded.\n   * @attr single-branch-expand\n   */\n  @property({ attribute: 'single-branch-expand', reflect: true, type: Boolean })\n  public singleBranchExpand = false;\n\n  /**\n   * Whether clicking over nodes will change their expanded state or not.\n   * @attr toggle-node-on-click\n   */\n  @property({ attribute: 'toggle-node-on-click', reflect: true, type: Boolean })\n  public toggleNodeOnClick = false;\n\n  /**\n   * The selection state of the tree.\n   * @attr\n   */\n  @property({ reflect: true })\n  public selection: TreeSelection = 'none';\n\n  /**\n   * Gets/Sets the locale used for getting language, affecting resource strings.\n   * @attr locale\n   */\n  @property()\n  public set locale(value: string) {\n    this._i18nController.locale = value;\n  }\n\n  public get locale() {\n    return this._i18nController.locale;\n  }\n\n  /**\n   * The resource strings for localization.\n   * Currently only aria-labels of the default expand/collapse icons are localized for the tree item.\n   */\n  @property({ attribute: false })\n  public set resourceStrings(value: ITreeResourceStrings) {\n    this._i18nController.resourceStrings = value;\n  }\n\n  public get resourceStrings(): ITreeResourceStrings {\n    return this._i18nController.resourceStrings;\n  }\n\n  /**\n   * @hidden @internal\n   * The tree's top-most items, i.e. its direct `igc-tree-item` light-DOM children.\n   */\n  public get _rootItems(): IgcTreeItemComponent[] {\n    return getTreeItemChildren(this);\n  }\n\n  /* blazorSuppress */\n  /**\n   * Returns all of the tree's items.\n   */\n  public get items(): IgcTreeItemComponent[] {\n    // A shared accumulator, rather than spreading each root's flattened\n    // descendants, which would copy every subtree an extra time.\n    const result: IgcTreeItemComponent[] = [];\n\n    for (const item of this._rootItems) {\n      result.push(item);\n      item._collectDescendants(result);\n    }\n\n    return result;\n  }\n\n  constructor() {\n    super();\n\n    addThemingController(this, all);\n\n    this.selectionService = new IgcTreeSelectionService(this);\n    this.navService = new IgcTreeNavigationService(this, this.selectionService);\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this._syncAria();\n    const items = this.items;\n\n    // set init to true for all items which are rendered along with the tree\n    for (const item of items) {\n      item.init = true;\n    }\n\n    // Seed the roving tabindex without moving DOM focus - connecting a tree must\n    // not pull focus away from wherever the user currently is.\n    const firstNotDisabledItem = items.find((i) => !i.disabled);\n    if (firstNotDisabledItem) {\n      firstNotDisabledItem.tabIndex = 0;\n      this.navService.focusItem(firstNotDisabledItem, false);\n    }\n  }\n\n  protected override willUpdate(changed: PropertyValues<this>): void {\n    super.willUpdate(changed);\n\n    if (this.hasUpdated && changed.has('selection')) {\n      this.selectionService.clearItemsSelection();\n    }\n\n    if (changed.has('singleBranchExpand')) {\n      this._singleBranchExpandChange();\n    }\n\n    if (ITEM_RENDER_DEPENDENCIES.some((prop) => changed.has(prop))) {\n      for (const item of this.items) {\n        item.requestUpdate();\n      }\n    }\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    super.updated(changed);\n    this._syncAria();\n  }\n\n  private _syncAria(): void {\n    this.setAttribute('role', 'tree');\n\n    // A tree that cannot be selected should not advertise itself as selectable.\n    setAriaState(\n      this,\n      'aria-multiselectable',\n      this.selection === 'none' ? null : 'true'\n    );\n  }\n\n  private _singleBranchExpandChange(): void {\n    if (!this.singleBranchExpand) {\n      return;\n    }\n\n    // The active item's branch stays open; everything else collapses.\n    const active = this.navService.activeItem;\n    const keepExpanded = new Set(active ? active.path.slice(0, -1) : []);\n\n    for (const item of this.items) {\n      if (!keepExpanded.has(item)) {\n        item.collapseWithEvent();\n      }\n    }\n  }\n\n  /* blazorSuppress */\n  /** @hidden @internal */\n  public expandToItem(item: IgcTreeItemComponent): void {\n    for (const ancestor of item.path.slice(0, -1)) {\n      ancestor.expanded = true;\n    }\n  }\n\n  /* blazorSuppress */\n  /** Select all items if the items collection is empty. Otherwise, select the items in the items collection. */\n  public select(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    if (items) {\n      this.selectionService.selectItemsWithNoEvent(items);\n      return;\n    }\n\n    // Cascading down from the roots already covers every descendant, so there\n    // is no need to walk the whole tree to build the list.\n    this.selectionService.selectItemsWithNoEvent(\n      this.selection === 'cascade' ? this._rootItems : this.items\n    );\n  }\n\n  /* blazorSuppress */\n  /** Deselect all items if the items collection is empty. Otherwise, deselect the items in the items collection. */\n  public deselect(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    this.selectionService.deselectItemsWithNoEvent(items);\n  }\n\n  /* blazorSuppress */\n  /**\n   * Expands all of the passed items.\n   * If no items are passed, expands ALL items.\n   */\n  public expand(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    for (const item of items ?? this.items) {\n      item.expanded = true;\n    }\n  }\n\n  /* blazorSuppress */\n  /**\n   * Collapses all of the passed items.\n   * If no items are passed, collapses ALL items.\n   */\n  public collapse(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    for (const item of items ?? this.items) {\n      item.expanded = false;\n    }\n  }\n\n  protected override render() {\n    return html`<slot></slot>`;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-tree': IgcTreeComponent;\n  }\n}\n"]}
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/components/tree/tree.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type ITreeResourceStrings,\n  TreeResourceStringsEN,\n} from 'igniteui-i18n-core';\nimport { html, LitElement, type PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { blazorAdditionalDependencies } from '#internals/decorators/blazorAdditionalDependencies.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport type { I18nControllerConfig } from '#internals/i18n/i18n-controller.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { I18nMixin } from '#internals/mixins/i18n.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport type { TreeSelection } from '../types.js';\nimport { styles } from './themes/container.base.css.js';\nimport { all } from './themes/container.js';\nimport IgcTreeItemComponent from './tree-item.js';\nimport {\n  getTreeItemChildren,\n  type IgcTreeComponentEventMap,\n  setAriaState,\n} from './tree.common.js';\nimport { IgcTreeNavigationService } from './tree.navigation.js';\nimport { IgcTreeSelectionService } from './tree.selection.js';\n\n/**\n * Tree properties that items read while rendering. The tree is not a reactive\n * source for them, so changing one has to re-render the items by hand or they\n * keep rendering stale output.\n *\n * Prefer reading tree state at event time over extending this - a handler\n * always sees the current value and costs no re-render. Direction is handled in\n * CSS via `:dir()` for the same reason.\n */\nconst ITEM_RENDER_DEPENDENCIES = ['selection', 'resourceStrings'] as const;\n\nconst i18n: I18nControllerConfig<ITreeResourceStrings> = {\n  defaultEN: TreeResourceStringsEN,\n};\n\n/**\n * The tree allows users to represent hierarchical data in a tree-view structure,\n * maintaining parent-child relationships, as well as to define static tree-view structure without a corresponding data model.\n *\n * @element igc-tree\n *\n * @slot - Renders the tree items inside default slot.\n *\n * @fires igcSelection - Emitted when item selection is changing, before the selection completes.\n * @fires igcItemCollapsed - Emitted when tree item is collapsed.\n * @fires igcItemCollapsing - Emitted when tree item is about to collapse.\n * @fires igcItemExpanded - Emitted when tree item is expanded.\n * @fires igcItemExpanding - Emitted when tree item is about to expand.\n * @fires igcActiveItem - Emitted when the tree's `active` item changes.\n */\n@blazorAdditionalDependencies('IgcTreeItemComponent')\nexport default class IgcTreeComponent extends I18nMixin(\n  EventEmitterMixin<IgcTreeComponentEventMap, Constructor<LitElement>>(\n    LitElement\n  ),\n  i18n\n) {\n  public static readonly tagName = 'igc-tree';\n  public static styles = styles;\n\n  /* blazorSuppress */\n  public static register() {\n    registerComponent(IgcTreeComponent, IgcTreeItemComponent);\n  }\n\n  /** @hidden @internal */\n  public selectionService!: IgcTreeSelectionService;\n\n  /** @hidden @internal */\n  public navService!: IgcTreeNavigationService;\n\n  /**\n   * Whether a single or multiple of a parent's child items can be expanded.\n   * @attr single-branch-expand\n   */\n  @property({ attribute: 'single-branch-expand', reflect: true, type: Boolean })\n  public singleBranchExpand = false;\n\n  /**\n   * Whether clicking over nodes will change their expanded state or not.\n   * @attr toggle-node-on-click\n   */\n  @property({ attribute: 'toggle-node-on-click', reflect: true, type: Boolean })\n  public toggleNodeOnClick = false;\n\n  /**\n   * The selection state of the tree.\n   * @attr\n   */\n  @property({ reflect: true })\n  public selection: TreeSelection = 'none';\n\n  /**\n   * @hidden @internal\n   * The tree's top-most items, i.e. its direct `igc-tree-item` light-DOM children.\n   */\n  public get _rootItems(): IgcTreeItemComponent[] {\n    return getTreeItemChildren(this);\n  }\n\n  /* blazorSuppress */\n  /**\n   * Returns all of the tree's items.\n   */\n  public get items(): IgcTreeItemComponent[] {\n    // A shared accumulator, rather than spreading each root's flattened\n    // descendants, which would copy every subtree an extra time.\n    const result: IgcTreeItemComponent[] = [];\n\n    for (const item of this._rootItems) {\n      result.push(item);\n      item._collectDescendants(result);\n    }\n\n    return result;\n  }\n\n  constructor() {\n    super();\n\n    addThemingController(this, all);\n\n    this.selectionService = new IgcTreeSelectionService(this);\n    this.navService = new IgcTreeNavigationService(this, this.selectionService);\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n    this._syncAria();\n    const items = this.items;\n\n    // set init to true for all items which are rendered along with the tree\n    for (const item of items) {\n      item.init = true;\n    }\n\n    // Seed the roving tabindex without moving DOM focus - connecting a tree must\n    // not pull focus away from wherever the user currently is.\n    const firstNotDisabledItem = items.find((i) => !i.disabled);\n    if (firstNotDisabledItem) {\n      firstNotDisabledItem.tabIndex = 0;\n      this.navService.focusItem(firstNotDisabledItem, false);\n    }\n  }\n\n  protected override willUpdate(changed: PropertyValues<this>): void {\n    super.willUpdate(changed);\n\n    if (this.hasUpdated && changed.has('selection')) {\n      this.selectionService.clearItemsSelection();\n    }\n\n    if (changed.has('singleBranchExpand')) {\n      this._singleBranchExpandChange();\n    }\n\n    if (ITEM_RENDER_DEPENDENCIES.some((prop) => changed.has(prop))) {\n      for (const item of this.items) {\n        item.requestUpdate();\n      }\n    }\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    super.updated(changed);\n    this._syncAria();\n  }\n\n  private _syncAria(): void {\n    this.setAttribute('role', 'tree');\n\n    // A tree that cannot be selected should not advertise itself as selectable.\n    setAriaState(\n      this,\n      'aria-multiselectable',\n      this.selection === 'none' ? null : 'true'\n    );\n  }\n\n  private _singleBranchExpandChange(): void {\n    if (!this.singleBranchExpand) {\n      return;\n    }\n\n    // The active item's branch stays open; everything else collapses.\n    const active = this.navService.activeItem;\n    const keepExpanded = new Set(active ? active.path.slice(0, -1) : []);\n\n    for (const item of this.items) {\n      if (!keepExpanded.has(item)) {\n        item.collapseWithEvent();\n      }\n    }\n  }\n\n  /* blazorSuppress */\n  /** @hidden @internal */\n  public expandToItem(item: IgcTreeItemComponent): void {\n    for (const ancestor of item.path.slice(0, -1)) {\n      ancestor.expanded = true;\n    }\n  }\n\n  /* blazorSuppress */\n  /** Select all items if the items collection is empty. Otherwise, select the items in the items collection. */\n  public select(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    if (items) {\n      this.selectionService.selectItemsWithNoEvent(items);\n      return;\n    }\n\n    // Cascading down from the roots already covers every descendant, so there\n    // is no need to walk the whole tree to build the list.\n    this.selectionService.selectItemsWithNoEvent(\n      this.selection === 'cascade' ? this._rootItems : this.items\n    );\n  }\n\n  /* blazorSuppress */\n  /** Deselect all items if the items collection is empty. Otherwise, deselect the items in the items collection. */\n  public deselect(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    this.selectionService.deselectItemsWithNoEvent(items);\n  }\n\n  /* blazorSuppress */\n  /**\n   * Expands all of the passed items.\n   * If no items are passed, expands ALL items.\n   */\n  public expand(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    for (const item of items ?? this.items) {\n      item.expanded = true;\n    }\n  }\n\n  /* blazorSuppress */\n  /**\n   * Collapses all of the passed items.\n   * If no items are passed, collapses ALL items.\n   */\n  public collapse(\n    /* alternateType: TreeItemCollection */\n    items?: IgcTreeItemComponent[]\n  ): void {\n    for (const item of items ?? this.items) {\n      item.expanded = false;\n    }\n  }\n\n  protected override render() {\n    return html`<slot></slot>`;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-tree': IgcTreeComponent;\n  }\n}\n"]}

package/components/tree/tree.navigation.d.ts

@@ -6,7 +6,7 @@ import type { IgcTreeSelectionService } from './tree.selection.js';
  * for the tree.
  *
  * The navigable set is never cached. It is derived on demand, only on an actual
- * keypress, by a lazy walk that prunes collapsed branches — so no work happens
+ * keypress, by a lazy walk that prunes collapsed branches - so no work happens
  * on item mount/expand/disable, and callers needing a single item stop as soon
  * as they have it.
  *

package/components/tree/tree.navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.navigation.js","sourceRoot":"","sources":["../../../src/components/tree/tree.navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  addKeybindings,\n  arrowDown,\n  arrowLeft,\n  arrowRight,\n  arrowUp,\n  ctrlKey,\n  endKey,\n  enterKey,\n  homeKey,\n  shiftKey,\n  spaceBar,\n} from '#internals/controllers/key-bindings.js';\nimport { isLTR, scrollIntoView } from '#internals/utils/dom.js';\nimport type IgcTreeItemComponent from './tree-item.js';\nimport type IgcTreeComponent from './tree.js';\nimport type { IgcTreeSelectionService } from './tree.selection.js';\n\n/**\n * Handles roving-tabindex keyboard navigation and active/focused item tracking\n * for the tree.\n *\n * The navigable set is never cached. It is derived on demand, only on an actual\n * keypress, by a lazy walk that prunes collapsed branches — so no work happens\n * on item mount/expand/disable, and callers needing a single item stop as soon\n * as they have it.\n *\n * @hidden @internal\n */\nexport class IgcTreeNavigationService {\n  private _focusedItem: IgcTreeItemComponent | null = null;\n  private _activeItem: IgcTreeItemComponent | null = null;\n\n  constructor(\n    private readonly tree: IgcTreeComponent,\n    private readonly selection: IgcTreeSelectionService\n  ) {\n    addKeybindings(tree, {\n      bindingDefaults: { preventDefault: true, repeat: true },\n    })\n      .set(homeKey, () => this.setFocusedAndActiveItem(this._firstNavigable()))\n      .set(endKey, () => this.setFocusedAndActiveItem(this._lastNavigable()))\n      .set(arrowLeft, this._arrowLeft)\n      .set(arrowRight, this._arrowRight)\n      .set(arrowUp, () => this._arrowVertical(-1, true))\n      .set(arrowDown, () => this._arrowVertical(1, true))\n      .set([ctrlKey, arrowUp], () => this._arrowVertical(-1, false))\n      .set([ctrlKey, arrowDown], () => this._arrowVertical(1, false))\n      .set('*', this._asterisk)\n      .set(spaceBar, () => this._space(false))\n      .set([shiftKey, spaceBar], () => this._space(true))\n      .set(enterKey, this._enter, { preventDefault: false });\n  }\n\n  public get focusedItem(): IgcTreeItemComponent | null {\n    return this._focusedItem;\n  }\n\n  public get activeItem(): IgcTreeItemComponent | null {\n    return this._activeItem;\n  }\n\n  public focusItem(\n    value: IgcTreeItemComponent | null,\n    shouldFocus = true\n  ): void {\n    if (this._focusedItem === value) {\n      return;\n    }\n\n    this._focusedItem?.removeAttribute('tabindex');\n    this._focusedItem = value;\n\n    if (this._focusedItem && shouldFocus) {\n      this._focusedItem.tabIndex = 0;\n      this._focusedItem.focus({ preventScroll: true });\n      scrollIntoView(this._focusedItem.wrapper);\n    }\n  }\n\n  public setActiveItem(\n    value: IgcTreeItemComponent | null,\n    shouldEmit = true\n  ): void {\n    if (this._activeItem === value) {\n      return;\n    }\n\n    if (this._activeItem) {\n      this._activeItem.active = false;\n    }\n\n    this._activeItem = value;\n\n    if (this._activeItem) {\n      this._activeItem.active = true;\n      if (shouldEmit) {\n        this.tree.emitEvent('igcActiveItem', { detail: this._activeItem });\n      }\n    }\n  }\n\n  /** Sets the item as focused (and optionally active). */\n  public setFocusedAndActiveItem(\n    item: IgcTreeItemComponent | undefined,\n    isActive = true,\n    shouldFocus = true\n  ): void {\n    if (!item) {\n      return;\n    }\n    if (isActive) {\n      this.setActiveItem(item);\n    }\n    this.focusItem(item, shouldFocus);\n  }\n\n  /** Called by a tree item on `disconnectedCallback`. */\n  public handleItemDisconnect(item: IgcTreeItemComponent): void {\n    if (this._activeItem === item) {\n      this.setActiveItem(null);\n    }\n    if (this._focusedItem === item) {\n      this.focusItem(null, false);\n      const next = this.tree.items.find((i) => !i.disabled);\n      if (next) {\n        next.tabIndex = 0;\n        this.focusItem(next, false);\n      }\n    }\n  }\n\n  //#region Visible/navigable item resolution (computed on demand, not cached)\n\n  /**\n   * Yields the keyboard-navigable items in document order.\n   *\n   * A disabled item is skipped but does not hide its subtree: only a\n   * *collapsed* ancestor removes descendants from the navigable set.\n   */\n  private *_navigable(\n    items: IgcTreeItemComponent[] = this.tree._rootItems\n  ): Generator<IgcTreeItemComponent, undefined> {\n    for (const item of items) {\n      if (!item.disabled) {\n        yield item;\n      }\n      if (item.expanded) {\n        yield* this._navigable(item.getChildren());\n      }\n    }\n  }\n\n  private _firstNavigable(): IgcTreeItemComponent | undefined {\n    return this._navigable().next().value;\n  }\n\n  private _lastNavigable(): IgcTreeItemComponent | undefined {\n    let last: IgcTreeItemComponent | undefined;\n    for (const item of this._navigable()) {\n      last = item;\n    }\n    return last;\n  }\n\n  /**\n   * Next/previous navigable item relative to `item`, or `item` itself if there\n   * isn't one.\n   */\n  private _adjacent(\n    item: IgcTreeItemComponent,\n    dir: 1 | -1\n  ): IgcTreeItemComponent {\n    const items = this._navigable();\n    let first: IgcTreeItemComponent | undefined;\n    let previous: IgcTreeItemComponent | undefined;\n\n    for (const current of items) {\n      first ??= current;\n\n      if (current === item) {\n        if (dir === -1) {\n          return previous ?? item;\n        }\n        const next = items.next();\n        return next.done ? item : next.value;\n      }\n      previous = current;\n    }\n\n    // `item` is not navigable itself - it can be focused while an ancestor is\n    // collapsed out from under it. Going forward that lands on the first\n    // navigable item; going backwards it stays put.\n    return (dir === 1 ? first : undefined) ?? item;\n  }\n\n  //#endregion\n\n  //#region Keyboard handlers\n\n  private readonly _arrowLeft = (): void => {\n    isLTR(this.tree)\n      ? this._collapseOrGoToParent()\n      : this._expandOrGoToFirstChild();\n  };\n\n  private readonly _arrowRight = (): void => {\n    isLTR(this.tree)\n      ? this._expandOrGoToFirstChild()\n      : this._collapseOrGoToParent();\n  };\n\n  private _collapseOrGoToParent(): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    if (item.expanded && item.getChildren().length) {\n      this.setActiveItem(item);\n      item.collapseWithEvent();\n      return;\n    }\n    if (item.parent && !item.parent.disabled) {\n      this.setFocusedAndActiveItem(item.parent);\n    }\n  }\n\n  private _expandOrGoToFirstChild(): void {\n    const item = this._focusedItem;\n    if (!item || item.getChildren().length === 0) {\n      return;\n    }\n    if (!item.expanded) {\n      this.setActiveItem(item);\n      item.expandWithEvent();\n      return;\n    }\n    const firstChild = item.getChildren().find((child) => !child.disabled);\n    if (firstChild) {\n      this.setFocusedAndActiveItem(firstChild);\n    }\n  }\n\n  private _arrowVertical(dir: 1 | -1, shouldActivate: boolean): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    const next = this._adjacent(item, dir);\n    if (next === item) {\n      return;\n    }\n    this.setFocusedAndActiveItem(next, shouldActivate);\n  }\n\n  private readonly _asterisk = (): void => {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    const siblings = item.parent\n      ? item.parent.getChildren()\n      : this.tree._rootItems;\n\n    for (const sibling of siblings) {\n      if (!sibling.disabled && !sibling.expanded && sibling.hasChildren) {\n        sibling.expandWithEvent();\n      }\n    }\n  };\n\n  private _space(shiftKey: boolean): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n\n    this.setActiveItem(item);\n\n    if (this.tree.selection === 'none') {\n      return;\n    }\n\n    if (shiftKey) {\n      this.selection.selectMultipleItems(item);\n      return;\n    }\n\n    item.selected\n      ? this.selection.deselectItem(item)\n      : this.selection.selectItem(item);\n  }\n\n  private readonly _enter = (): void => {\n    if (this._focusedItem) {\n      this.setActiveItem(this._focusedItem);\n    }\n  };\n\n  //#endregion\n}\n"]}
+{"version":3,"file":"tree.navigation.js","sourceRoot":"","sources":["../../../src/components/tree/tree.navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  addKeybindings,\n  arrowDown,\n  arrowLeft,\n  arrowRight,\n  arrowUp,\n  ctrlKey,\n  endKey,\n  enterKey,\n  homeKey,\n  shiftKey,\n  spaceBar,\n} from '#internals/controllers/key-bindings.js';\nimport { isLTR, scrollIntoView } from '#internals/utils/dom.js';\nimport type IgcTreeItemComponent from './tree-item.js';\nimport type IgcTreeComponent from './tree.js';\nimport type { IgcTreeSelectionService } from './tree.selection.js';\n\n/**\n * Handles roving-tabindex keyboard navigation and active/focused item tracking\n * for the tree.\n *\n * The navigable set is never cached. It is derived on demand, only on an actual\n * keypress, by a lazy walk that prunes collapsed branches - so no work happens\n * on item mount/expand/disable, and callers needing a single item stop as soon\n * as they have it.\n *\n * @hidden @internal\n */\nexport class IgcTreeNavigationService {\n  private _focusedItem: IgcTreeItemComponent | null = null;\n  private _activeItem: IgcTreeItemComponent | null = null;\n\n  constructor(\n    private readonly tree: IgcTreeComponent,\n    private readonly selection: IgcTreeSelectionService\n  ) {\n    addKeybindings(tree, {\n      bindingDefaults: { preventDefault: true, repeat: true },\n    })\n      .set(homeKey, () => this.setFocusedAndActiveItem(this._firstNavigable()))\n      .set(endKey, () => this.setFocusedAndActiveItem(this._lastNavigable()))\n      .set(arrowLeft, this._arrowLeft)\n      .set(arrowRight, this._arrowRight)\n      .set(arrowUp, () => this._arrowVertical(-1, true))\n      .set(arrowDown, () => this._arrowVertical(1, true))\n      .set([ctrlKey, arrowUp], () => this._arrowVertical(-1, false))\n      .set([ctrlKey, arrowDown], () => this._arrowVertical(1, false))\n      .set('*', this._asterisk)\n      .set(spaceBar, () => this._space(false))\n      .set([shiftKey, spaceBar], () => this._space(true))\n      .set(enterKey, this._enter, { preventDefault: false });\n  }\n\n  public get focusedItem(): IgcTreeItemComponent | null {\n    return this._focusedItem;\n  }\n\n  public get activeItem(): IgcTreeItemComponent | null {\n    return this._activeItem;\n  }\n\n  public focusItem(\n    value: IgcTreeItemComponent | null,\n    shouldFocus = true\n  ): void {\n    if (this._focusedItem === value) {\n      return;\n    }\n\n    this._focusedItem?.removeAttribute('tabindex');\n    this._focusedItem = value;\n\n    if (this._focusedItem && shouldFocus) {\n      this._focusedItem.tabIndex = 0;\n      this._focusedItem.focus({ preventScroll: true });\n      scrollIntoView(this._focusedItem.wrapper);\n    }\n  }\n\n  public setActiveItem(\n    value: IgcTreeItemComponent | null,\n    shouldEmit = true\n  ): void {\n    if (this._activeItem === value) {\n      return;\n    }\n\n    if (this._activeItem) {\n      this._activeItem.active = false;\n    }\n\n    this._activeItem = value;\n\n    if (this._activeItem) {\n      this._activeItem.active = true;\n      if (shouldEmit) {\n        this.tree.emitEvent('igcActiveItem', { detail: this._activeItem });\n      }\n    }\n  }\n\n  /** Sets the item as focused (and optionally active). */\n  public setFocusedAndActiveItem(\n    item: IgcTreeItemComponent | undefined,\n    isActive = true,\n    shouldFocus = true\n  ): void {\n    if (!item) {\n      return;\n    }\n    if (isActive) {\n      this.setActiveItem(item);\n    }\n    this.focusItem(item, shouldFocus);\n  }\n\n  /** Called by a tree item on `disconnectedCallback`. */\n  public handleItemDisconnect(item: IgcTreeItemComponent): void {\n    if (this._activeItem === item) {\n      this.setActiveItem(null);\n    }\n    if (this._focusedItem === item) {\n      this.focusItem(null, false);\n      const next = this.tree.items.find((i) => !i.disabled);\n      if (next) {\n        next.tabIndex = 0;\n        this.focusItem(next, false);\n      }\n    }\n  }\n\n  //#region Visible/navigable item resolution (computed on demand, not cached)\n\n  /**\n   * Yields the keyboard-navigable items in document order.\n   *\n   * A disabled item is skipped but does not hide its subtree: only a\n   * *collapsed* ancestor removes descendants from the navigable set.\n   */\n  private *_navigable(\n    items: IgcTreeItemComponent[] = this.tree._rootItems\n  ): Generator<IgcTreeItemComponent, undefined> {\n    for (const item of items) {\n      if (!item.disabled) {\n        yield item;\n      }\n      if (item.expanded) {\n        yield* this._navigable(item.getChildren());\n      }\n    }\n  }\n\n  private _firstNavigable(): IgcTreeItemComponent | undefined {\n    return this._navigable().next().value;\n  }\n\n  private _lastNavigable(): IgcTreeItemComponent | undefined {\n    let last: IgcTreeItemComponent | undefined;\n    for (const item of this._navigable()) {\n      last = item;\n    }\n    return last;\n  }\n\n  /**\n   * Next/previous navigable item relative to `item`, or `item` itself if there\n   * isn't one.\n   */\n  private _adjacent(\n    item: IgcTreeItemComponent,\n    dir: 1 | -1\n  ): IgcTreeItemComponent {\n    const items = this._navigable();\n    let first: IgcTreeItemComponent | undefined;\n    let previous: IgcTreeItemComponent | undefined;\n\n    for (const current of items) {\n      first ??= current;\n\n      if (current === item) {\n        if (dir === -1) {\n          return previous ?? item;\n        }\n        const next = items.next();\n        return next.done ? item : next.value;\n      }\n      previous = current;\n    }\n\n    // `item` is not navigable itself - it can be focused while an ancestor is\n    // collapsed out from under it. Going forward that lands on the first\n    // navigable item; going backwards it stays put.\n    return (dir === 1 ? first : undefined) ?? item;\n  }\n\n  //#endregion\n\n  //#region Keyboard handlers\n\n  private readonly _arrowLeft = (): void => {\n    isLTR(this.tree)\n      ? this._collapseOrGoToParent()\n      : this._expandOrGoToFirstChild();\n  };\n\n  private readonly _arrowRight = (): void => {\n    isLTR(this.tree)\n      ? this._expandOrGoToFirstChild()\n      : this._collapseOrGoToParent();\n  };\n\n  private _collapseOrGoToParent(): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    if (item.expanded && item.getChildren().length) {\n      this.setActiveItem(item);\n      item.collapseWithEvent();\n      return;\n    }\n    if (item.parent && !item.parent.disabled) {\n      this.setFocusedAndActiveItem(item.parent);\n    }\n  }\n\n  private _expandOrGoToFirstChild(): void {\n    const item = this._focusedItem;\n    if (!item || item.getChildren().length === 0) {\n      return;\n    }\n    if (!item.expanded) {\n      this.setActiveItem(item);\n      item.expandWithEvent();\n      return;\n    }\n    const firstChild = item.getChildren().find((child) => !child.disabled);\n    if (firstChild) {\n      this.setFocusedAndActiveItem(firstChild);\n    }\n  }\n\n  private _arrowVertical(dir: 1 | -1, shouldActivate: boolean): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    const next = this._adjacent(item, dir);\n    if (next === item) {\n      return;\n    }\n    this.setFocusedAndActiveItem(next, shouldActivate);\n  }\n\n  private readonly _asterisk = (): void => {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n    const siblings = item.parent\n      ? item.parent.getChildren()\n      : this.tree._rootItems;\n\n    for (const sibling of siblings) {\n      if (!sibling.disabled && !sibling.expanded && sibling.hasChildren) {\n        sibling.expandWithEvent();\n      }\n    }\n  };\n\n  private _space(shiftKey: boolean): void {\n    const item = this._focusedItem;\n    if (!item) {\n      return;\n    }\n\n    this.setActiveItem(item);\n\n    if (this.tree.selection === 'none') {\n      return;\n    }\n\n    if (shiftKey) {\n      this.selection.selectMultipleItems(item);\n      return;\n    }\n\n    item.selected\n      ? this.selection.deselectItem(item)\n      : this.selection.selectItem(item);\n  }\n\n  private readonly _enter = (): void => {\n    if (this._focusedItem) {\n      this.setActiveItem(this._focusedItem);\n    }\n  };\n\n  //#endregion\n}\n"]}

package/components/validation-container/validation-container.d.ts

@@ -1,7 +1,7 @@
 import { LitElement, nothing, type TemplateResult } from 'lit';
 import { type IgcFormControl } from '#internals/mixins/forms/types.js';
 /** Configuration for the validation container. */
-interface ValidationContainerConfig {
+export interface ValidationContainerConfig {
     /** The id attribute for the validation container. */
     id?: string;
     /** Project the validation container to the given slot inside the host shadow DOM. */
@@ -70,4 +70,3 @@ declare global {
         'igc-validator': IgcValidationContainerComponent;
     }
 }
-export {};

package/components/validation-container/validation-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation-container.js","sourceRoot":"","sources":["../../../src/components/validation-container/validation-container.ts"],"names":[],"mappings":"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","sourcesContent":["import { html, isServer, LitElement, nothing, type TemplateResult } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { createAbortHandle } from '#internals/abort-handler.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport {\n  type IgcFormControl,\n  InternalInvalidEvent,\n  InternalResetEvent,\n} from '#internals/mixins/forms/types.js';\nimport { partMap } from '#internals/part-map.js';\nimport { isEmpty } from '#internals/utils/arrays.js';\nimport { toKebabCase } from '#internals/utils/strings.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcIconComponent from '../icon/icon.js';\nimport { all as inputThemes } from '../input/themes/themes.js';\nimport { styles as shared } from './themes/shared/validator.common.css.js';\nimport { styles } from './themes/validator.base.css.js';\n\n/** Configuration for the validation container. */\ninterface ValidationContainerConfig {\n  /** The id attribute for the validation container. */\n  id?: string;\n  /** Project the validation container to the given slot inside the host shadow DOM. */\n  slot?: string;\n  /** Additional part(s) that should be bound to the validation container. */\n  part?: string;\n  /** Whether the validation container should expose a helper-text slot. */\n  hasHelperText?: boolean;\n}\n\nconst ALL_SLOTS_SELECTOR = 'slot';\nconst QUERY_CONFIG: AssignedNodesOptions = { flatten: true };\n\n/**\n * Validity flags rendered as validation message slots, in a stable order so the\n * generated slots are deterministic across browsers.\n */\nconst VALIDITY_KEYS: ReadonlyArray<keyof ValidityStateFlags> = [\n  'badInput',\n  'customError',\n  'patternMismatch',\n  'rangeOverflow',\n  'rangeUnderflow',\n  'stepMismatch',\n  'tooLong',\n  'tooShort',\n  'typeMismatch',\n  'valueMissing',\n];\n\n/**\n * Yields the active validation slot names for the given validity state, in a\n * stable order (`invalid` first, then each failing constraint).\n */\nfunction* activeValidationSlots(validity: ValidityState): Generator<string> {\n  if (!validity.valid) {\n    yield 'invalid';\n  }\n\n  for (const key of VALIDITY_KEYS) {\n    if (validity[key]) {\n      yield toKebabCase(key);\n    }\n  }\n}\n\n/* blazorSuppress */\n/**\n * @element igc-validator\n *\n * @csspart helper-text - The base wrapper\n * @csspart validation-message - The validation error message container\n * @csspart validation-icon - The validation error icon\n */\nexport default class IgcValidationContainerComponent extends LitElement {\n  public static readonly tagName = 'igc-validator';\n  public static override styles = [styles, shared];\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcValidationContainerComponent, IgcIconComponent);\n  }\n\n  /**\n   * Creates a validation container for the given form control.\n   *\n   * The container will render validation messages based on the control's validity state\n   * and projected content, and reflect the control's `invalid` state.\n   */\n  public static create(\n    host: IgcFormControl,\n    config: ValidationContainerConfig = {\n      id: 'helper-text',\n      hasHelperText: true,\n    }\n  ): TemplateResult {\n    const helperText = config.hasHelperText\n      ? html`<slot name=\"helper-text\" slot=\"helper-text\"></slot>`\n      : nothing;\n\n    // `hasUpdated` is false during SSR and the host's hydrating render, so both\n    // emit `nothing`. The real validation slots are projected post-hydration.\n    const validationSlots = host.hasUpdated\n      ? Iterator.from(activeValidationSlots(host.validity))\n          .map((name) => html`<slot name=${name} slot=${name}></slot>`)\n          .toArray()\n      : nothing;\n\n    return html`\n      <igc-validator\n        id=${ifDefined(config.id)}\n        part=${ifDefined(config.part)}\n        slot=${ifDefined(config.slot)}\n        ?invalid=${host.invalid}\n        .target=${host}\n        exportparts=\"helper-text, validation-message, validation-icon\"\n      >\n        ${helperText}${validationSlots}\n      </igc-validator>\n    `;\n  }\n\n  private readonly _abortHandle = createAbortHandle();\n  private _target!: IgcFormControl;\n\n  /**\n   * Whether the container is in an invalid state.\n   *\n   * This is reflected from the target's `invalid` property,\n   * and is used to determine whether to render the validation message slots.\n   */\n  @property({ type: Boolean })\n  public invalid = false;\n\n  /**\n   * The form control whose validity state is being rendered. The target's `invalid`\n   * property is reflected to the container, and its validity state is used to\n   * determine which validation message slots to render.\n   *\n   * @remarks The target must be set for the container to function, and should be\n   * set before the first update cycle for SSR compatibility. When using the\n   * `create` method, the target is set automatically.\n   */\n  @property({ attribute: false })\n  public set target(value: IgcFormControl) {\n    if (this._target === value) {\n      return;\n    }\n\n    this._abortHandle.abort();\n    const { signal } = this._abortHandle;\n\n    this._target = value;\n    this._target.addEventListener(InternalInvalidEvent, this, { signal });\n    this._target.addEventListener(InternalResetEvent, this, { signal });\n  }\n\n  public get target(): IgcFormControl {\n    return this._target;\n  }\n\n  constructor() {\n    super();\n    addThemingController(this, inputThemes);\n  }\n\n  protected override createRenderRoot(): HTMLElement | DocumentFragment {\n    const root = super.createRenderRoot();\n    root.addEventListener('slotchange', this);\n    return root;\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    switch (event.type) {\n      case InternalInvalidEvent:\n        this.invalid = true;\n        break;\n      case InternalResetEvent:\n        this.invalid = false;\n        break;\n    }\n\n    this.requestUpdate();\n  }\n\n  /**\n   * Collects the projection state of the container slots in a single DOM pass.\n   *\n   * @returns Whether every slot is empty and the set of non-empty validation\n   * slot names (i.e. excluding `helper-text`).\n   */\n  private _collectProjectedSlots(): {\n    isProjectionEmpty: boolean;\n    validation: Set<string>;\n  } {\n    const validation = new Set<string>();\n\n    if (isServer || !this.hasUpdated) {\n      return { isProjectionEmpty: false, validation };\n    }\n\n    const slots = Array.from(\n      this.renderRoot.querySelectorAll<HTMLSlotElement>(ALL_SLOTS_SELECTOR)\n    );\n    let isProjectionEmpty = true;\n\n    for (const slot of slots) {\n      if (isEmpty(slot.assignedElements(QUERY_CONFIG))) {\n        continue;\n      }\n\n      isProjectionEmpty = false;\n      if (slot.name && slot.name !== 'helper-text') {\n        validation.add(slot.name);\n      }\n    }\n\n    return { isProjectionEmpty, validation };\n  }\n\n  protected _renderValidationMessage(\n    slotName: string,\n    projectedSlots: ReadonlySet<string>\n  ): TemplateResult {\n    const hasProjectedIcon = projectedSlots.has(slotName);\n    const parts = { 'validation-message': true, empty: !hasProjectedIcon };\n    const icon = hasProjectedIcon\n      ? html`\n          <igc-icon\n            aria-hidden=\"true\"\n            name=\"error\"\n            part=\"validation-icon\"\n          ></igc-icon>\n        `\n      : nothing;\n\n    return html`<div part=${partMap(parts)}>\n      ${icon}<slot name=${slotName}></slot>\n    </div>`;\n  }\n\n  protected _renderHelper(\n    hasValidationProjection: boolean\n  ): TemplateResult | typeof nothing {\n    return this.invalid && hasValidationProjection\n      ? nothing\n      : html`<slot name=\"helper-text\"></slot>`;\n  }\n\n  protected override firstUpdated(): void {\n    // The first render is intentionally neutral to match the SSR output during\n    // hydration. Only reconcile when the field hydrated in an invalid state, and\n    // do it off the current update cycle so we don't schedule an update as a side\n    // effect of the one in progress, projecting the real validation messages now\n    // that `hasUpdated` is true.\n    if (this.invalid) {\n      queueMicrotask(() => this.requestUpdate());\n    }\n  }\n\n  protected override render(): TemplateResult {\n    const { isProjectionEmpty, validation } = this._collectProjectedSlots();\n    const messages =\n      this.hasUpdated && this.invalid\n        ? Iterator.from(activeValidationSlots(this.target.validity))\n            .map((name) => this._renderValidationMessage(name, validation))\n            .toArray()\n        : nothing;\n\n    return html`\n      <div\n        part=${partMap({ 'helper-text': true, empty: isProjectionEmpty })}\n        aria-live=\"polite\"\n      >\n        ${messages}${this._renderHelper(!isEmpty(validation))}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-validator': IgcValidationContainerComponent;\n  }\n}\n"]}
+{"version":3,"file":"validation-container.js","sourceRoot":"","sources":["../../../src/components/validation-container/validation-container.ts"],"names":[],"mappings":"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","sourcesContent":["import { html, isServer, LitElement, nothing, type TemplateResult } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { createAbortHandle } from '#internals/abort-handler.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport {\n  type IgcFormControl,\n  InternalInvalidEvent,\n  InternalResetEvent,\n} from '#internals/mixins/forms/types.js';\nimport { partMap } from '#internals/part-map.js';\nimport { isEmpty } from '#internals/utils/arrays.js';\nimport { toKebabCase } from '#internals/utils/strings.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcIconComponent from '../icon/icon.js';\nimport { all as inputThemes } from '../input/themes/themes.js';\nimport { styles as shared } from './themes/shared/validator.common.css.js';\nimport { styles } from './themes/validator.base.css.js';\n\n/** Configuration for the validation container. */\nexport interface ValidationContainerConfig {\n  /** The id attribute for the validation container. */\n  id?: string;\n  /** Project the validation container to the given slot inside the host shadow DOM. */\n  slot?: string;\n  /** Additional part(s) that should be bound to the validation container. */\n  part?: string;\n  /** Whether the validation container should expose a helper-text slot. */\n  hasHelperText?: boolean;\n}\n\nconst ALL_SLOTS_SELECTOR = 'slot';\nconst QUERY_CONFIG: AssignedNodesOptions = { flatten: true };\n\n/**\n * Validity flags rendered as validation message slots, in a stable order so the\n * generated slots are deterministic across browsers.\n */\nconst VALIDITY_KEYS: ReadonlyArray<keyof ValidityStateFlags> = [\n  'badInput',\n  'customError',\n  'patternMismatch',\n  'rangeOverflow',\n  'rangeUnderflow',\n  'stepMismatch',\n  'tooLong',\n  'tooShort',\n  'typeMismatch',\n  'valueMissing',\n];\n\n/**\n * Yields the active validation slot names for the given validity state, in a\n * stable order (`invalid` first, then each failing constraint).\n */\nfunction* activeValidationSlots(validity: ValidityState): Generator<string> {\n  if (!validity.valid) {\n    yield 'invalid';\n  }\n\n  for (const key of VALIDITY_KEYS) {\n    if (validity[key]) {\n      yield toKebabCase(key);\n    }\n  }\n}\n\n/* blazorSuppress */\n/**\n * @element igc-validator\n *\n * @csspart helper-text - The base wrapper\n * @csspart validation-message - The validation error message container\n * @csspart validation-icon - The validation error icon\n */\nexport default class IgcValidationContainerComponent extends LitElement {\n  public static readonly tagName = 'igc-validator';\n  public static override styles = [styles, shared];\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcValidationContainerComponent, IgcIconComponent);\n  }\n\n  /**\n   * Creates a validation container for the given form control.\n   *\n   * The container will render validation messages based on the control's validity state\n   * and projected content, and reflect the control's `invalid` state.\n   */\n  public static create(\n    host: IgcFormControl,\n    config: ValidationContainerConfig = {\n      id: 'helper-text',\n      hasHelperText: true,\n    }\n  ): TemplateResult {\n    const helperText = config.hasHelperText\n      ? html`<slot name=\"helper-text\" slot=\"helper-text\"></slot>`\n      : nothing;\n\n    // `hasUpdated` is false during SSR and the host's hydrating render, so both\n    // emit `nothing`. The real validation slots are projected post-hydration.\n    const validationSlots = host.hasUpdated\n      ? Iterator.from(activeValidationSlots(host.validity))\n          .map((name) => html`<slot name=${name} slot=${name}></slot>`)\n          .toArray()\n      : nothing;\n\n    return html`\n      <igc-validator\n        id=${ifDefined(config.id)}\n        part=${ifDefined(config.part)}\n        slot=${ifDefined(config.slot)}\n        ?invalid=${host.invalid}\n        .target=${host}\n        exportparts=\"helper-text, validation-message, validation-icon\"\n      >\n        ${helperText}${validationSlots}\n      </igc-validator>\n    `;\n  }\n\n  private readonly _abortHandle = createAbortHandle();\n  private _target!: IgcFormControl;\n\n  /**\n   * Whether the container is in an invalid state.\n   *\n   * This is reflected from the target's `invalid` property,\n   * and is used to determine whether to render the validation message slots.\n   */\n  @property({ type: Boolean })\n  public invalid = false;\n\n  /**\n   * The form control whose validity state is being rendered. The target's `invalid`\n   * property is reflected to the container, and its validity state is used to\n   * determine which validation message slots to render.\n   *\n   * @remarks The target must be set for the container to function, and should be\n   * set before the first update cycle for SSR compatibility. When using the\n   * `create` method, the target is set automatically.\n   */\n  @property({ attribute: false })\n  public set target(value: IgcFormControl) {\n    if (this._target === value) {\n      return;\n    }\n\n    this._abortHandle.abort();\n    const { signal } = this._abortHandle;\n\n    this._target = value;\n    this._target.addEventListener(InternalInvalidEvent, this, { signal });\n    this._target.addEventListener(InternalResetEvent, this, { signal });\n  }\n\n  public get target(): IgcFormControl {\n    return this._target;\n  }\n\n  constructor() {\n    super();\n    addThemingController(this, inputThemes);\n  }\n\n  protected override createRenderRoot(): HTMLElement | DocumentFragment {\n    const root = super.createRenderRoot();\n    root.addEventListener('slotchange', this);\n    return root;\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    switch (event.type) {\n      case InternalInvalidEvent:\n        this.invalid = true;\n        break;\n      case InternalResetEvent:\n        this.invalid = false;\n        break;\n    }\n\n    this.requestUpdate();\n  }\n\n  /**\n   * Collects the projection state of the container slots in a single DOM pass.\n   *\n   * @returns Whether every slot is empty and the set of non-empty validation\n   * slot names (i.e. excluding `helper-text`).\n   */\n  private _collectProjectedSlots(): {\n    isProjectionEmpty: boolean;\n    validation: Set<string>;\n  } {\n    const validation = new Set<string>();\n\n    if (isServer || !this.hasUpdated) {\n      return { isProjectionEmpty: false, validation };\n    }\n\n    const slots = Array.from(\n      this.renderRoot.querySelectorAll<HTMLSlotElement>(ALL_SLOTS_SELECTOR)\n    );\n    let isProjectionEmpty = true;\n\n    for (const slot of slots) {\n      if (isEmpty(slot.assignedElements(QUERY_CONFIG))) {\n        continue;\n      }\n\n      isProjectionEmpty = false;\n      if (slot.name && slot.name !== 'helper-text') {\n        validation.add(slot.name);\n      }\n    }\n\n    return { isProjectionEmpty, validation };\n  }\n\n  protected _renderValidationMessage(\n    slotName: string,\n    projectedSlots: ReadonlySet<string>\n  ): TemplateResult {\n    const hasProjectedIcon = projectedSlots.has(slotName);\n    const parts = { 'validation-message': true, empty: !hasProjectedIcon };\n    const icon = hasProjectedIcon\n      ? html`\n          <igc-icon\n            aria-hidden=\"true\"\n            name=\"error\"\n            part=\"validation-icon\"\n          ></igc-icon>\n        `\n      : nothing;\n\n    return html`<div part=${partMap(parts)}>\n      ${icon}<slot name=${slotName}></slot>\n    </div>`;\n  }\n\n  protected _renderHelper(\n    hasValidationProjection: boolean\n  ): TemplateResult | typeof nothing {\n    return this.invalid && hasValidationProjection\n      ? nothing\n      : html`<slot name=\"helper-text\"></slot>`;\n  }\n\n  protected override firstUpdated(): void {\n    // The first render is intentionally neutral to match the SSR output during\n    // hydration. Only reconcile when the field hydrated in an invalid state, and\n    // do it off the current update cycle so we don't schedule an update as a side\n    // effect of the one in progress, projecting the real validation messages now\n    // that `hasUpdated` is true.\n    if (this.invalid) {\n      queueMicrotask(() => this.requestUpdate());\n    }\n  }\n\n  protected override render(): TemplateResult {\n    const { isProjectionEmpty, validation } = this._collectProjectedSlots();\n    const messages =\n      this.hasUpdated && this.invalid\n        ? Iterator.from(activeValidationSlots(this.target.validity))\n            .map((name) => this._renderValidationMessage(name, validation))\n            .toArray()\n        : nothing;\n\n    return html`\n      <div\n        part=${partMap({ 'helper-text': true, empty: isProjectionEmpty })}\n        aria-live=\"polite\"\n      >\n        ${messages}${this._renderHelper(!isEmpty(validation))}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-validator': IgcValidationContainerComponent;\n  }\n}\n"]}

package/components/virtualization/engine.d.ts

@@ -1,52 +1,53 @@
 import type { ScrollAlignment, VisibleRange } from './types.js';
 /**
- * Pure scroll-math engine for a single axis of virtual scrolling. All size
- * state is held in a Fenwick tree.
+ * Pure scroll-math engine for one axis of virtual scrolling. A Fenwick tree
+ * holds all size state.
  *
- * ### Virtual vs DOM coordinates
+ * ### Virtual and DOM coordinates
  *
- * Browsers cap how far an element can be scrolled. When the summed item size
- * exceeds that cap, the engine compresses the *virtual* space (`0…totalSize`)
- * into the *DOM* space the browser can represent (`0…domSize`) by the factor
- * `_virtualRatio`. Every offset crossing that boundary is scaled: incoming
- * scroll positions are multiplied by the ratio, outgoing offsets divided by
- * it. Item sizes render at their real px size and so are always virtual.
+ * Browsers limit how far an element can scroll. When the total item size is
+ * larger than that limit, the engine compresses the *virtual* space
+ * (`0…totalSize`) into the *DOM* space the browser can represent
+ * (`0…domSize`) by the factor `_virtualRatio`. Each offset that crosses that
+ * boundary is scaled: incoming scroll positions are multiplied by the ratio,
+ * and outgoing offsets are divided by it. Items render at their real pixel
+ * size, so item sizes are always virtual.
  */
 export declare class VirtualScrollEngine {
     private _maxBrowserSize;
     /**
-     * The ratio `totalSize / maxBrowserSize` when `totalSize` exceeds the
-     * maximum DOM coordinate the browser supports; `1` otherwise.
-     * Used to map virtual scroll positions to DOM scroll positions.
+     * The ratio `totalSize / maxBrowserSize` when `totalSize` is larger than
+     * the maximum DOM coordinate the browser supports; `1` otherwise.
+     * Maps virtual scroll positions to DOM scroll positions.
      */
     private _virtualRatio;
     /** Binary Indexed Tree for O(log N) size queries and updates. */
     private _tree;
     /**
-     * Called whenever item sizes or the item count change, e.g.
-     * `() => this.requestUpdate()`.
+     * Called when item sizes or the item count change.
+     * Example: `() => this.requestUpdate()`.
      */
     onSizeChange: (() => void) | null;
     /** Total virtual size of all items in px. */
     get totalSize(): number;
     /** Total size in DOM space, clamped to the maximum browser size. */
     get domSize(): number;
-    /** Probes the document for the maximum browser size and rescales. */
+    /** Measures the maximum browser size for the document and rescales. */
     initMaxBrowserSize(doc: Document): void;
     /**
-     * Grows or shrinks the internal sizes array to `length`. Measured sizes
-     * below `retainCount` are preserved; the rest is refilled with
-     * `estimatedSize` and marked unmeasured. Callers that only append can leave
-     * `retainCount` at its default; callers whose data changed identity at some
-     * index must pass it, so the stale measurements behind it are discarded.
+     * Resizes the internal sizes array to `length`. Measured sizes below
+     * `retainCount` are kept. The remainder is filled with `estimatedSize` and
+     * marked unmeasured. Callers that only append can keep the default
+     * `retainCount`. Callers whose data changed identity at some index must
+     * pass that index, so the stale measurements after it are discarded.
      */
     resize(length: number, estimatedSize: number, retainCount?: number): void;
     /** Records the measured DOM size for a single item. */
     measureItem(index: number, size: number): void;
     /**
-     * Applies a new estimated size to every item not yet measured in the DOM.
-     * Use this when `estimatedItemSize` changes but the item count doesn't, so
-     * `resize` would be a no-op.
+     * Applies a new estimated size to each item that is not measured in the
+     * DOM. Use this when `estimatedItemSize` changes but the item count does
+     * not, because `resize` is then a no-op.
      */
     updateEstimatedSize(estimatedSize: number): void;
     /**
@@ -56,36 +57,37 @@ export declare class VirtualScrollEngine {
     getScrollOffsetForIndex(index: number): number;
     /**
      * The largest DOM scroll offset the host can reach for the given viewport
-     * size. Requesting anything beyond it silently does nothing, so offsets
-     * handed out to a caller that waits for the scroll to settle are clamped
-     * to it.
+     * size. A request beyond it does nothing, so offsets given to a caller
+     * that waits for the scroll to settle are clamped to it.
      */
     private _getMaxScrollOffset;
     /**
-     * Returns the DOM scroll offset that positions the item at `index`
-     * according to `align` within a `viewportSize` px viewport, clamped to the
+     * Returns the DOM scroll offset that positions the item at `index` in a
+     * `viewportSize` px viewport, aligned by `align` and clamped to the
      * reachable scroll range.
      *
      * The slack is computed in virtual space against the item's real size and
-     * converted to DOM space once, at the end: a DOM pixel is worth
-     * `_virtualRatio` virtual pixels, so mixing the two would scale the slack.
+     * converted to DOM space once, at the end. One DOM pixel equals
+     * `_virtualRatio` virtual pixels, so mixed coordinates would scale the
+     * slack.
      */
     getAlignedScrollOffset(index: number, viewportSize: number, align: ScrollAlignment): number;
     /**
-     * Whether the item at `index` needs no scrolling to be seen at the given DOM
-     * scroll position: either it sits entirely inside the viewport, or it is
-     * larger than the viewport and already covers it end to end. The latter
-     * mirrors native `scrollIntoView({ block: 'nearest' })`.
+     * Whether the item at `index` is visible without more scrolling at the
+     * given DOM scroll position. True when the item is fully inside the
+     * viewport, or when it is larger than the viewport and covers it fully.
+     * The second case matches native `scrollIntoView({ block: 'nearest' })`.
      */
     isIndexInView(index: number, scrollPosition: number, viewportSize: number): boolean;
     /**
-     * Returns the visible + over-scanned item range for the given scroll state.
+     * Returns the visible and over-scanned item range for the given scroll
+     * state.
      */
     getVisibleRange(scrollPosition: number, viewportSize: number, overScan: number): VisibleRange;
     /**
-     * Sum of the actual sizes of the items in [startIndex, endIndex]. Clamps the
-     * content translate offset so rendered items never overflow past `domSize`
-     * under coordinate compression.
+     * Sum of the actual sizes of the items in [startIndex, endIndex]. The
+     * render pass uses it to clamp the content translate offset, so rendered
+     * items do not overflow past `domSize` under coordinate compression.
      */
     getPhysicalRangeSize(startIndex: number, endIndex: number): number;
     private _updateVirtualRatio;