@heartlandone/vega 2.101.0 → 2.103.0

package/dist/collection/components/vega-rich-text-editor/extensions/paste/controllers/chooser-positioner.js

@@ -0,0 +1,107 @@
+/** Computes paste chooser placement from the paste pointer or saved caret range. */
+export class ChooserPositioner {
+  constructor(getHostElement, getSelectionRange) {
+    this.getHostElement = getHostElement;
+    this.getSelectionRange = getSelectionRange;
+  }
+  /**
+   * @param {ClipboardEvent} event Originating paste event.
+   * @returns {ChooserPosition} Position in viewport coordinates.
+   */
+  compute(event) {
+    var _a, _b, _c;
+    const hostEl = this.getHostElement();
+    if (!hostEl) {
+      return { left: 0, top: 0, placement: ['bottom', 'top'] };
+    }
+    const hostRect = hostEl.getBoundingClientRect();
+    const viewportHeight = (_b = (_a = hostEl.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.innerHeight) !== null && _b !== void 0 ? _b : window.innerHeight;
+    const pointerEvent = event;
+    const hasPointer = typeof pointerEvent.clientX === 'number' &&
+      pointerEvent.clientX > 0 &&
+      typeof pointerEvent.clientY === 'number' &&
+      pointerEvent.clientY > 0;
+    const caretRect = hasPointer ? null : this.getCaretRect();
+    const CHOOSER_GAP_PX = 8;
+    const CHOOSER_MIN_MARGIN_PX = 12;
+    const CHOOSER_WIDTH_PX = 220;
+    const CHOOSER_FALLBACK_OFFSET_PX = 40;
+    const CHOOSER_MIN_VISIBLE_BELOW_SPACE_PX = 88;
+    const baseLeft = hasPointer
+      ? pointerEvent.clientX
+      : (_c = caretRect === null || caretRect === void 0 ? void 0 : caretRect.left) !== null && _c !== void 0 ? _c : hostRect.left + CHOOSER_MIN_MARGIN_PX;
+    const baseTop = hasPointer
+      ? pointerEvent.clientY
+      : caretRect
+        ? caretRect.bottom
+        : hostRect.top + CHOOSER_FALLBACK_OFFSET_PX;
+    const maxLeft = Math.max(hostRect.left + CHOOSER_MIN_MARGIN_PX, hostRect.right - CHOOSER_WIDTH_PX);
+    const left = Math.min(Math.max(baseLeft, hostRect.left + CHOOSER_MIN_MARGIN_PX), maxLeft);
+    const top = Math.max(baseTop + CHOOSER_GAP_PX, hostRect.top + CHOOSER_MIN_MARGIN_PX);
+    const availableBelow = viewportHeight - top - CHOOSER_MIN_MARGIN_PX;
+    const availableAbove = top - CHOOSER_MIN_MARGIN_PX;
+    const placement = availableBelow >= CHOOSER_MIN_VISIBLE_BELOW_SPACE_PX || availableBelow >= availableAbove
+      ? ['bottom', 'top']
+      : ['top', 'bottom'];
+    return { left, top, placement };
+  }
+  /** @returns {DOMRect | null} Best available caret rectangle. */
+  getCaretRect() {
+    const range = this.getSelectionRange();
+    if (!range) {
+      return null;
+    }
+    const rect = range.getBoundingClientRect();
+    if (!this.isUnavailableRect(rect)) {
+      return rect;
+    }
+    const domRectList = range.getClientRects();
+    if (domRectList.length > 0) {
+      return domRectList[0];
+    }
+    return this.getRangeContainerRect(range);
+  }
+  /**
+   * @param {DOMRect} rect Rectangle to inspect.
+   * @returns {boolean} Whether the rectangle has no usable position or dimensions.
+   */
+  isUnavailableRect(rect) {
+    return rect.width === 0 && rect.height === 0 && rect.left === 0 && rect.top === 0;
+  }
+  /**
+   * @param {Range} range Selection range whose container should be measured.
+   * @returns {DOMRect | null} Best available rectangle for the range container.
+   */
+  getRangeContainerRect(range) {
+    var _a, _b, _c, _d, _e, _f;
+    const containerNode = (_a = range.startContainer) !== null && _a !== void 0 ? _a : null;
+    if (!containerNode) {
+      return null;
+    }
+    if (containerNode.nodeType === Node.ELEMENT_NODE) {
+      const containerElement = containerNode;
+      const previousNode = (_b = containerElement.childNodes[range.startOffset - 1]) !== null && _b !== void 0 ? _b : null;
+      const currentNode = (_c = containerElement.childNodes[range.startOffset]) !== null && _c !== void 0 ? _c : null;
+      return ((_e = (_d = this.getNodeRect(previousNode)) !== null && _d !== void 0 ? _d : this.getNodeRect(currentNode)) !== null && _e !== void 0 ? _e : this.getNodeRect(containerElement));
+    }
+    return (_f = this.getNodeRect(containerNode)) !== null && _f !== void 0 ? _f : this.getNodeRect(containerNode.parentNode);
+  }
+  /**
+   * @param {Node | null} node DOM node to measure.
+   * @returns {DOMRect | null} Element-backed rectangle for the node.
+   */
+  getNodeRect(node) {
+    var _a, _b;
+    if (!node) {
+      return null;
+    }
+    if (node.nodeType === Node.TEXT_NODE) {
+      return (_b = (_a = node.parentElement) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect()) !== null && _b !== void 0 ? _b : null;
+    }
+    if (node.nodeType === Node.ELEMENT_NODE) {
+      const rect = node.getBoundingClientRect();
+      return this.isUnavailableRect(rect) ? null : rect;
+    }
+    return null;
+  }
+}

package/dist/collection/components/vega-rich-text-editor/extensions/paste/controllers/paste-chooser-controller.js

@@ -0,0 +1,91 @@
+import { RTEPasteChooserUI } from '../paste-chooser-ui';
+/** Owns chooser rendering and all listener bookkeeping used to dismiss it. */
+export class PasteChooserController {
+  constructor(positioner, onModeSelect, onClearPayload) {
+    this.positioner = positioner;
+    this.onModeSelect = onModeSelect;
+    this.onClearPayload = onClearPayload;
+    this.chooserUI = null;
+    this.listenerDocument = null;
+    this.listenerWindow = null;
+    this.contentHostEl = null;
+    /**
+     * @param {Event} event Pointer event captured on the document.
+     */
+    this.handleOutsidePointerDown = (event) => {
+      if (!this.chooserUI) {
+        return;
+      }
+      const eventPath = typeof event.composedPath === 'function' ? event.composedPath() : [];
+      if (!this.chooserUI.includesEventPath(eventPath)) {
+        this.clear();
+      }
+    };
+    /**
+     * @param {KeyboardEvent} event Keyboard event captured on the document.
+     */
+    this.handleOutsideKeyDown = (event) => {
+      if (event.key === 'Escape') {
+        this.clear();
+      }
+    };
+    /**
+     * Clears the chooser when a relevant scroll container scrolls.
+     *
+     * @returns {void}
+     */
+    this.handleOutsideScroll = () => this.clear();
+  }
+  /**
+   * @returns {RTEPasteChooserUI | null} Current chooser UI, or `null` when closed.
+   */
+  get ui() {
+    return this.chooserUI;
+  }
+  /**
+   * @param {HTMLElement | null} hostEl Rich text editor host element.
+   * @param {HTMLElement | null} contentHostEl Scrollable content host element.
+   * @param {ClipboardEvent} pasteEvent Originating paste event used for positioning.
+   * @param {boolean} showWordOption Whether to display the Word paste option.
+   */
+  open(hostEl, contentHostEl, pasteEvent, showWordOption) {
+    var _a, _b, _c;
+    const hostRoot = (_a = hostEl === null || hostEl === void 0 ? void 0 : hostEl.shadowRoot) !== null && _a !== void 0 ? _a : null;
+    if (!hostRoot || !hostEl) {
+      return;
+    }
+    this.clear(false);
+    const position = this.positioner.compute(pasteEvent);
+    this.chooserUI = new RTEPasteChooserUI(hostRoot, { onModeSelect: this.onModeSelect }, { showWordOption });
+    this.chooserUI.open(position);
+    this.contentHostEl = contentHostEl;
+    this.listenerDocument = hostEl.ownerDocument;
+    this.listenerWindow = this.listenerDocument.defaultView;
+    this.listenerDocument.addEventListener('mousedown', this.handleOutsidePointerDown, true);
+    this.listenerDocument.addEventListener('keydown', this.handleOutsideKeyDown, true);
+    this.listenerDocument.addEventListener('scroll', this.handleOutsideScroll, true);
+    (_b = this.listenerWindow) === null || _b === void 0 ? void 0 : _b.addEventListener('scroll', this.handleOutsideScroll, true);
+    (_c = this.contentHostEl) === null || _c === void 0 ? void 0 : _c.addEventListener('scroll', this.handleOutsideScroll);
+  }
+  /**
+   * @param {boolean} [clearPayload] Whether to also clear the pending paste payload.
+   */
+  clear(clearPayload = true) {
+    var _a, _b, _c;
+    (_a = this.contentHostEl) === null || _a === void 0 ? void 0 : _a.removeEventListener('scroll', this.handleOutsideScroll);
+    this.contentHostEl = null;
+    (_b = this.listenerWindow) === null || _b === void 0 ? void 0 : _b.removeEventListener('scroll', this.handleOutsideScroll, true);
+    this.listenerWindow = null;
+    if (this.listenerDocument) {
+      this.listenerDocument.removeEventListener('mousedown', this.handleOutsidePointerDown, true);
+      this.listenerDocument.removeEventListener('keydown', this.handleOutsideKeyDown, true);
+      this.listenerDocument.removeEventListener('scroll', this.handleOutsideScroll, true);
+      this.listenerDocument = null;
+    }
+    (_c = this.chooserUI) === null || _c === void 0 ? void 0 : _c.destroy();
+    this.chooserUI = null;
+    if (clearPayload) {
+      this.onClearPayload();
+    }
+  }
+}

package/dist/collection/components/vega-rich-text-editor/extensions/paste/controllers/paste-event-interceptor.js

@@ -0,0 +1,47 @@
+/** Owns the native paste listener and synchronous clipboard payload capture. */
+export class PasteEventInterceptor {
+  constructor(selectionSnapshotService, onPasteCaptured) {
+    this.selectionSnapshotService = selectionSnapshotService;
+    this.onPasteCaptured = onPasteCaptured;
+    this.editableEl = null;
+    /**
+     * @param {ClipboardEvent} event Native paste event to capture.
+     */
+    this.handlePasteEvent = (event) => {
+      const clipboardData = event.clipboardData;
+      if (!clipboardData) {
+        return;
+      }
+      const html = clipboardData.getData('text/html') || '';
+      const text = clipboardData.getData('text/plain') || '';
+      const rtf = clipboardData.getData('text/rtf') || '';
+      if (!html && !text) {
+        event.preventDefault();
+        event.stopPropagation();
+        return;
+      }
+      event.preventDefault();
+      event.stopPropagation();
+      const snapshot = this.selectionSnapshotService.capture();
+      const files = clipboardData.files ? Array.from(clipboardData.files) : [];
+      this.onPasteCaptured({ html, text, range: snapshot.range, selectedNodes: snapshot.selectedNodes, files, rtf }, event);
+    };
+  }
+  /**
+   * @param {HTMLDivElement | null} editableEl Editable content element to observe.
+   */
+  attach(editableEl) {
+    var _a;
+    this.detach();
+    this.editableEl = editableEl;
+    (_a = this.editableEl) === null || _a === void 0 ? void 0 : _a.addEventListener('paste', this.handlePasteEvent);
+  }
+  /**
+   * Detaches the current native paste listener.
+   */
+  detach() {
+    var _a;
+    (_a = this.editableEl) === null || _a === void 0 ? void 0 : _a.removeEventListener('paste', this.handlePasteEvent);
+    this.editableEl = null;
+  }
+}

package/dist/collection/components/vega-rich-text-editor/extensions/paste/controllers/selection-snapshot-service.js

@@ -0,0 +1,54 @@
+/** Captures and restores native and editor selection state around chooser interaction. */
+export class SelectionSnapshotService {
+  constructor(getContext) {
+    this.getContext = getContext;
+  }
+  /**
+   * @returns {SelectionSnapshot} Captured native and editor selection state.
+   */
+  capture() {
+    var _a;
+    const context = this.getContext();
+    const selection = context === null || context === void 0 ? void 0 : context.getSelection();
+    const range = selection && selection.rangeCount > 0 ? selection.getRangeAt(0).cloneRange() : null;
+    const selectedNodes = ((_a = context === null || context === void 0 ? void 0 : context.getSelectedNodes) === null || _a === void 0 ? void 0 : _a.call(context)) || [];
+    return { range, selectedNodes: [...selectedNodes] };
+  }
+  /**
+   * @param {PendingPastePayload} payload Paste payload containing captured selection state.
+   */
+  restore(payload) {
+    this.restoreRange(payload.range);
+    this.restoreControllerState(payload);
+  }
+  /**
+   * @param {PendingPastePayload} payload Paste payload containing editor selection state.
+   */
+  restoreControllerState(payload) {
+    const context = this.getContext();
+    if (!payload.range || !context) {
+      return;
+    }
+    const rangeOptions = {
+      startNode: payload.range.startContainer,
+      endNode: payload.range.endContainer,
+      startOffset: payload.range.startOffset,
+      endOffset: payload.range.endOffset,
+    };
+    context.setSelectedNodes(payload.selectedNodes || [], rangeOptions);
+  }
+  /**
+   * @param {Range | null} range Native selection range to restore.
+   */
+  restoreRange(range) {
+    var _a;
+    if (!range) {
+      return;
+    }
+    const selection = (_a = this.getContext()) === null || _a === void 0 ? void 0 : _a.getSelection();
+    if (selection) {
+      selection.removeAllRanges();
+      selection.addRange(range);
+    }
+  }
+}

package/dist/collection/components/vega-rich-text-editor/extensions/paste/parse-local-images-helper/image-extractor.js

@@ -0,0 +1,17 @@
+import { PasteImageParser } from './paste-image-parser';
+/** Extracts local image previews from strategy output. */
+export class ImageExtractor {
+  constructor(parser = new PasteImageParser()) {
+    this.parser = parser;
+  }
+  /**
+   * @param {string} html HTML content containing local image references.
+   * @param {File[]} files Clipboard image files.
+   * @param {string} rtf Rich text clipboard content used to resolve images.
+   * @returns {ParseLocalImagesResult} HTML and extracted local image previews.
+   */
+  extract(html, files, rtf) {
+    const clipboardFileContent = { files, rtf };
+    return this.parser.parseLocalImages(html, clipboardFileContent);
+  }
+}

package/dist/collection/components/vega-rich-text-editor/extensions/paste/paste-chooser-ui.js

@@ -112,6 +112,7 @@ export class RTEPasteChooserUI {
     itemsContainer.setAttribute('slot', 'items');
     const dropdownItems = [
       this.createDropdownItem(doc, RTEPasteMode.RICH, VegaInternalTranslation.t('Use rich text'), RTEPasteChooserUI.CHOOSER_RICH_ATTR),
+      this.createDropdownItem(doc, RTEPasteMode.PLAIN, VegaInternalTranslation.t('Use plain text'), RTEPasteChooserUI.CHOOSER_PLAIN_ATTR),
     ];
     if (this.options.showWordOption) {
       dropdownItems.push(this.createDropdownItem(doc, RTEPasteMode.WORD, VegaInternalTranslation.t('Use Word'), RTEPasteChooserUI.CHOOSER_WORD_ATTR));
@@ -120,7 +121,7 @@ export class RTEPasteChooserUI {
     dropdownEl.append(itemsContainer);
     dropdownEl.addEventListener('vegaDropdownClick', (event) => {
       const mode = event.detail;
-      if (mode === RTEPasteMode.RICH || mode === RTEPasteMode.WORD) {
+      if (mode === RTEPasteMode.RICH || mode === RTEPasteMode.PLAIN || mode === RTEPasteMode.WORD) {
         this.callbacks.onModeSelect(mode);
       }
     });
@@ -150,5 +151,6 @@ export class RTEPasteChooserUI {
 })();
 RTEPasteChooserUI.CHOOSER_ATTR = 'data-rte-paste-chooser';
 RTEPasteChooserUI.CHOOSER_RICH_ATTR = 'data-rte-paste-type-rich';
+RTEPasteChooserUI.CHOOSER_PLAIN_ATTR = 'data-rte-paste-type-plain';
 RTEPasteChooserUI.CHOOSER_WORD_ATTR = 'data-rte-paste-type-word';
 RTEPasteChooserUI.CHOOSER_TRIGGER_ATTR = 'data-rte-paste-trigger';