@heartlandone/vega 2.94.0 → 2.96.0

package/dist/collection/helpers/backdrop/shared-backdrop-manager.js

@@ -21,7 +21,9 @@ export class SharedBackdropManager extends VegaSlimmer {
       managerClass.visibilityIntents.set(this, false);
       managerClass.consumerCount++;
     }
-    this.ensureBackdrop();
+    if (!this.usesLazyBackdrop()) {
+      this.ensureBackdrop();
+    }
   }
   /**
    * Unregister this consumer and remove shared backdrop when last consumer disconnects.
@@ -91,6 +93,16 @@ export class SharedBackdropManager extends VegaSlimmer {
       this.syncVisibility();
     }
   }
+  /**
+   * Whether this manager type handles backdrop existence lazily (on demand).
+   * Override and return `true` in derived classes that create/remove the backdrop
+   * per visibility cycle instead of at connectedCallback.
+   *
+   * @returns {boolean} False by default — backdrop is created eagerly at connect time.
+   */
+  usesLazyBackdrop() {
+    return false;
+  }
   /**
    * Ensure a backdrop exists for this subclass and return it.
    *
@@ -127,10 +139,29 @@ export class SharedBackdropManager extends VegaSlimmer {
   syncVisibility() {
     const managerClass = this.constructor;
     const shouldShow = managerClass.visibilityIntentCount > 0;
+    if (this.usesLazyBackdrop()) {
+      this.syncLazyBackdrop(shouldShow);
+      return;
+    }
     if (managerClass.backdropRef) {
       managerClass.backdropRef.visible = shouldShow;
     }
   }
+  /**
+   * Handles visibility sync for manager types that opt into lazy backdrop lifecycle.
+   * When `shouldShow` is true the backdrop is created (if needed) and made visible.
+   * When `shouldShow` is false the backdrop is removed from the DOM.
+   *
+   * @param {boolean} shouldShow - Whether the backdrop should be visible.
+   */
+  syncLazyBackdrop(shouldShow) {
+    if (!shouldShow) {
+      this.removeBackdrop();
+      return;
+    }
+    const backdrop = this.ensureBackdrop();
+    backdrop.visible = true;
+  }
   /**
    * Reset stale static shared state when the tracked backdrop is no longer in the DOM.
    */

package/dist/collection/helpers/event-manager/event-id/component-event-id-map.js

@@ -1,4 +1,4 @@
-import { VegaExpand, VegaAdditionalLinkClick, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, VegaUserChange, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaTodayClick, VegaDropdownShow, VegaDropdownHide, VegaDropdownSelectAllClick, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaNativeInputChange, VegaFocus, VegaBlur, VegaSuggestionItemClick, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSourceCodeChange, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowDragDrop, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
+import { VegaExpand, VegaAdditionalLinkClick, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, VegaUserChange, VegaRemove, VegaCreate, VegaSearch, VegaDropdownSelectAllClick, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaTodayClick, VegaDropdownShow, VegaDropdownHide, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaNativeInputChange, VegaFocus, VegaBlur, VegaSuggestionItemClick, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSourceCodeChange, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowDragDrop, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
 const entries = [
   ['vega-accordion', [VegaExpand]],
   ['vega-app-footer', [VegaAdditionalLinkClick]],
@@ -22,7 +22,7 @@ const entries = [
   ['vega-color-picker', [VegaChange]],
   ['vega-color-swatch', [VegaClick]],
   ['vega-color-swatch-picker', [VegaChange]],
-  ['vega-combo-box', [VegaChange, VegaCreate, VegaSearch]],
+  ['vega-combo-box', [VegaChange, VegaCreate, VegaSearch, VegaDropdownSelectAllClick]],
   ['vega-date-picker', [VegaChange, VegaMonthYearChange]],
   ['vega-date-picker-calendar', [VegaClear, VegaMonthYearChange, VegaSelectionChange, VegaTodayClick]],
   [
@@ -62,7 +62,15 @@ const entries = [
   ['vega-input-range', [VegaChange]],
   [
     'vega-input-select',
-    [VegaChange, VegaSearch, VegaSearchTrigger, VegaShow, VegaHide, VegaLabelButtonClick],
+    [
+      VegaChange,
+      VegaSearch,
+      VegaSearchTrigger,
+      VegaShow,
+      VegaHide,
+      VegaLabelButtonClick,
+      VegaDropdownSelectAllClick,
+    ],
   ],
   ['vega-item-toggle', [VegaToggleStatus]],
   ['vega-modal', [VegaOpen, VegaClose]],

package/dist/collection/helpers/slimmers/a11y-tree-slimmer.js

@@ -0,0 +1,54 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { MapToComponentField, MapToComponentMethod, VegaSlimmer } from 'vega-slimmer/core';
+import { applyA11yTree } from '../a11y-tree/a11y-tree-applier';
+/**
+ * Generic A11y Tree slimmer.
+ *
+ * Hooks `componentDidRender` and projects the component's semantic A11y
+ * Tree onto its shadow DOM using the strategy resolved for the current
+ * browser engine.
+ *
+ * ## Opt-in steps for a component
+ *
+ * 1. Tag render targets with `data-a11y-id="<stable-id>"` in the renderer.
+ * 2. Author a `build<Component>A11yTree(host)` function (see
+ *    `a11y-node-dto.ts` for the DTO helpers that make this ergonomic).
+ * 3. Inject this slimmer with `@InjectVegaSlimmer()`:
+ *
+ * ```ts
+ * @InjectVegaSlimmer()
+ * protected a11yTreeSlimmer = new A11yTreeSlimmer<HTMLVegaFooElement>(
+ *   host => buildFooA11yTree({ title: host.title, description: host.description }),
+ * );
+ * ```
+ *
+ * The slimmer handles strategy selection, patch application, and cleanup
+ * on every subsequent render.
+ *
+ * @template T - The concrete `HTMLElement` subtype for the component host.
+ */
+export class A11yTreeSlimmer extends VegaSlimmer {
+  constructor(buildA11yTree) {
+    super();
+    this.buildA11yTree = buildA11yTree;
+  }
+  /**
+   * Called by Stencil after each render. Projects the semantic A11y Tree
+   * onto the shadow DOM via the resolved browser-engine strategy.
+   */
+  projectA11yTree() {
+    const tree = this.buildA11yTree(this.host);
+    applyA11yTree(tree, this.host);
+  }
+}
+__decorate([
+  MapToComponentField()
+], A11yTreeSlimmer.prototype, "host", void 0);
+__decorate([
+  MapToComponentMethod('componentDidRender')
+], A11yTreeSlimmer.prototype, "projectA11yTree", null);

package/dist/collection/helpers/slimmers/element-appender/element-appender-slimmer.js

@@ -16,10 +16,12 @@ import { HoverTriggerStrategy } from './trigger-strategies/hover-trigger-strateg
 import { NoneTriggerStrategy } from './trigger-strategies/none-trigger-strategy';
 import { isEATriggerStrategy } from '../../../types/type-guard';
 import { tryGetDocument } from '../../../utils/try-get-document';
+import { ClipOnScrollModifier } from './visibility-modifiers/clip-on-scroll-modifier';
 export class ElementAppenderSlimmer extends VegaSlimmer {
   constructor(showConfigFactory, getTrigger, isDropdownShowName = 'isDropdownShow', disableInteractiveGetter = () => false) {
     super();
     this.hierarchyTreeManager = new ElementAppenderHierarchyTreeManager(this);
+    this.visibilityModifiers = [new ClipOnScrollModifier()];
     /**
      * It adds event listeners to the target and the appendable element
      */
@@ -125,6 +127,33 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
         // itself, so no forced recalculation is needed there.
         const forceAdjust = !(e instanceof Event) || e.target !== tryGetDocument();
         (_a = this.elementAppender) === null || _a === void 0 ? void 0 : _a.onScroll(forceAdjust);
+        this.executeVisibilityModifiers({ kind: 'scroll', event: e });
+      }
+    };
+    /**
+     * Runs every enabled visibility modifier against the current show config and
+     * routes their actions to the appender. Modifiers are viewport-level,
+     * cross-cutting concerns that run in parallel with (not in place of) the
+     * selected trigger strategy — they only affect the appendable's visual
+     * clipping, never its logical open state.
+     */
+    this.executeVisibilityModifiers = (event) => {
+      if (!this.showConfig || !this.elementAppender)
+        return;
+      for (const modifier of this.visibilityModifiers) {
+        if (!modifier.isEnabled(this.showConfig))
+          continue;
+        const result = modifier.evaluate({
+          target: this.showConfig.target,
+          appendableElement: this.showConfig.appendableElement,
+          showConfig: this.showConfig,
+          currentState: { isVisible: this.isShowing() },
+          event,
+        });
+        if (result.nextAction === 'clip-hide')
+          this.elementAppender.setClipHidden(true);
+        else if (result.nextAction === 'clip-show')
+          this.elementAppender.setClipHidden(false);
       }
     };
     /* A timer that will hide the dropdown after a certain amount of time. */

package/dist/collection/helpers/slimmers/element-appender/visibility-modifiers/clip-on-scroll-modifier.js

@@ -0,0 +1,70 @@
+/**
+ * Returns the flattened-tree parent of a node so we can walk from inside a shadow
+ * tree up to the top-level document: assigned slot → parent element → shadow
+ * host.
+ *
+ * @param {Node} node - The node whose flattened-tree parent should be returned.
+ * @returns {HTMLElement | null} The flattened-tree parent, or null when the walk has reached the top.
+ */
+export function flatParent(node) {
+  var _a;
+  const slot = (_a = node.assignedSlot) !== null && _a !== void 0 ? _a : null;
+  if (slot)
+    return slot;
+  const parent = node.parentElement;
+  if (parent)
+    return parent;
+  const root = node.getRootNode();
+  return root.host ? root.host : null;
+}
+/**
+ * Returns true when the trigger is clipped out of view by the visual viewport
+ * or by any scrollable ancestor.
+ *
+ * @param {HTMLElement} target - The trigger element to test against the viewport and scrollable ancestors.
+ * @returns {boolean} True when the trigger is clipped and the appendable should be hidden.
+ */
+export function isTriggerClipped(target) {
+  const t = target.getBoundingClientRect();
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  if (t.bottom <= 0 || t.top >= vh || t.right <= 0 || t.left >= vw) {
+    return true;
+  }
+  let node = flatParent(target);
+  while (node) {
+    const style = getComputedStyle(node);
+    if (/(auto|scroll)/.test(style.overflowX + ' ' + style.overflowY)) {
+      const r = node.getBoundingClientRect();
+      if (t.bottom <= r.top || t.top >= r.bottom || t.right <= r.left || t.left >= r.right) {
+        return true;
+      }
+    }
+    node = flatParent(node);
+  }
+  return false;
+}
+/**
+ * Clip-hides an appendable while its trigger is scrolled out of view and
+ * restores it when the trigger returns, without touching the popup's logical
+ * open state. Applies to every appender consumer.
+ */
+export class ClipOnScrollModifier {
+  /**
+   * @returns {boolean} Always true — geometry alone decides clip vs restore in `evaluate`.
+   */
+  isEnabled() {
+    return true;
+  }
+  /**
+   * Evaluates whether the appendable should be clip-hidden or restored based
+   * on the current trigger geometry.
+   *
+   * @param {VegaEAVisibilityContext} context - Evaluation context.
+   * @returns {VegaEAVisibilityResult} The next clip action.
+   */
+  evaluate(context) {
+    const clipped = isTriggerClipped(context.target);
+    return { nextAction: clipped ? 'clip-hide' : 'clip-show' };
+  }
+}

package/dist/collection/helpers/slimmers/element-appender/visibility-modifiers/visibility-modifier.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/collection/helpers/ui/element-appender.js

@@ -111,6 +111,22 @@ export class ElementAppender {
       this.adjustPosition(true);
     }
   }
+  /**
+   * Toggles the appendable's visibility without changing its logical open
+   * state. Used to visually clip the popup when the trigger is out of view.
+   *
+   * @param {boolean} clipped - true to hide, false to show
+   */
+  setClipHidden(clipped) {
+    if (!this.showConfig)
+      return;
+    if (clipped) {
+      this.hideElementAppender(this.showConfig.appendableElement);
+    }
+    else {
+      this.showElementAppender(this.showConfig.appendableElement);
+    }
+  }
   /* istanbul ignore next */
   /**
    * It removes the z-index from the appendable element, removes the appendable element from the DOM, and

package/dist/esm/{app-globals-f2336686.js → app-globals-d7b651c1.js}

@@ -1,6 +1,6 @@
 import { F as FeatureFlag } from './feature-flag-controller-3fd04ea9.js';
-import { V as VegaLoader, a as VegaNotify, b as VegaEventManager, c as VegaZIndexManager, w as waitForVega, d as VegaSkeletonLoader, e as VegaTranslation, f as VegaRTETokenExtension, g as VegaRTELanguageExtension, h as VegaRTEDefaultLineHeightOptions, i as VegaRTEFunctionExtension, j as VegaRTETableExtension, k as VegaRTEHorizontalLineExtension, l as VegaRTEBlockquoteExtension, m as VegaRTESpecialCharactersExtension, n as VegaRTEFindReplaceExtension, o as VegaRTESpecialCharactersEssentials, p as VegaRTESpecialCharactersLatin, q as VegaRTESpecialCharactersMathematical, r as VegaRTESpecialCharactersArrows, s as VegaRTESpecialCharactersCurrency, t as VegaRTESpecialCharactersText, u as VegaRTELineHeightExtension, v as VegaRTEPasteExtension, x as VegaRTEFullscreenExtension, y as VegaRTECopyExtension, z as VegaRTECutExtension, A as VegaCalendarPeriodFactory } from './token-extension-9896879b.js';
-import { V as VegaThemeManager } from './split-cell-operation-359f8082.js';
+import { V as VegaLoader, a as VegaNotify, b as VegaEventManager, c as VegaZIndexManager, w as waitForVega, d as VegaSkeletonLoader, e as VegaTranslation, f as VegaRTETokenExtension, g as VegaRTELanguageExtension, h as VegaRTEDefaultLineHeightOptions, i as VegaRTEFunctionExtension, j as VegaRTETableExtension, k as VegaRTEHorizontalLineExtension, l as VegaRTEBlockquoteExtension, m as VegaRTESpecialCharactersExtension, n as VegaRTEFindReplaceExtension, o as VegaRTESpecialCharactersEssentials, p as VegaRTESpecialCharactersLatin, q as VegaRTESpecialCharactersMathematical, r as VegaRTESpecialCharactersArrows, s as VegaRTESpecialCharactersCurrency, t as VegaRTESpecialCharactersText, u as VegaRTELineHeightExtension, v as VegaRTEPasteExtension, x as VegaRTEFullscreenExtension, y as VegaRTECopyExtension, z as VegaRTECutExtension, A as VegaCalendarPeriodFactory } from './token-extension-40c32bcc.js';
+import { V as VegaThemeManager } from './split-cell-operation-7f3058ad.js';
 import { M as MapToComponentMethod, V as VegaSlimmer, s as setVegaLogLevel, G as GlobalSlimmersRegistry } from './global-slimmer-registry-17c4efd4.js';
 import { V as VegaDialog } from './vega-dialog-controller-726b74f9.js';
 import { T as TypographyUrls } from './typography-19c3b9be.js';
@@ -12,12 +12,12 @@ import { U as UPDATE_TRANSLATION } from './static-subject-title-1c86e974.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
 import { O as Observer } from './observer-3959f9dd.js';
 import { f as forceUpdate } from './index-090d31ca.js';
-import { V as VegaRTEContent } from './content-state-8032467a.js';
+import { V as VegaRTEContent } from './content-state-79ca99e5.js';
 import { v as vegaNonceManager, s as setVegaNonce } from './vega-nonce-manager-497e5eb5.js';
-import { V as VegaRTEPresetToolbarItems } from './code-block-e12588fe.js';
-import { V as VegaRTELinkExtension } from './link-extension-97fcb8fb.js';
+import { V as VegaRTEPresetToolbarItems } from './code-block-0a88b481.js';
+import { V as VegaRTELinkExtension } from './link-extension-09534514.js';
 import './type-guard-ec5e8628.js';
-import { V as VegaRTEImageExtension } from './image-extension-b6c7e4a7.js';
+import { V as VegaRTEImageExtension } from './image-extension-48a96f98.js';
 
 var __decorate$2 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -424,7 +424,7 @@ function injectVegaCalendarPeriodFactoryIntoGlobal() {
  * Inject VegaPublicValidationRules to global as a public api
  */
 function injectVegaPublicValidationRules() {
-  void import('./public-rules-c06f0d2a.js').then((module) => {
+  void import('./public-rules-5eb03ef0.js').then((module) => {
     Object.entries(module).forEach(([name, value]) => {
       globalThis[name] = value;
     });

package/dist/esm/{child-nodes-event-prevent-slimmer-96c14f5a.js → child-nodes-event-prevent-slimmer-82626871.js}

@@ -1,5 +1,5 @@
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
-import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-48690e5b.js';
+import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-2ecc9186.js';
 import { v as vegaEnvManager } from './vega-env-manager-8f8dc473.js';
 import { F as FeatureFlag } from './feature-flag-controller-3fd04ea9.js';