@globalpayments/vega 2.55.1 → 2.57.0

package/dist/collection/components/vega-rich-text-editor/test/dto/blocks/list-block.test.js

@@ -79,7 +79,7 @@ describe('bullet list', () => {
       ],
     });
     expect(bulletListBlock.isNotEmpty()).toEqual(true);
-    bulletListBlock.blocks[0].nodes[0].text = '';
+    bulletListBlock.children[0].children[0].text = '';
     expect(bulletListBlock.isNotEmpty()).toEqual(true);
     const childrenListBlock = RTEListBlock.from({
       id: '1-1-2',
@@ -98,9 +98,9 @@ describe('bullet list', () => {
         },
       ],
     });
-    bulletListBlock.blocks[0].children = [childrenListBlock];
+    bulletListBlock.children[0].nestList = [childrenListBlock];
     expect(bulletListBlock.isNotEmpty()).toEqual(true);
-    childrenListBlock.blocks[0].nodes[0].text = '';
+    childrenListBlock.children[0].children[0].text = '';
     expect(bulletListBlock.isNotEmpty()).toEqual(true);
   });
 });
@@ -124,7 +124,7 @@ describe('number list', () => {
       ],
     });
     expect(listBlock.isNotEmpty()).toEqual(true);
-    listBlock.blocks[0].nodes[0].text = '';
+    listBlock.children[0].children[0].text = '';
     expect(listBlock.isNotEmpty()).toEqual(true);
     const childrenListBlock = RTEListBlock.from({
       id: '1-1-2',
@@ -143,9 +143,9 @@ describe('number list', () => {
         },
       ],
     });
-    listBlock.blocks[0].children = [childrenListBlock];
+    listBlock.children[0].nestList = [childrenListBlock];
     expect(listBlock.isNotEmpty()).toEqual(true);
-    childrenListBlock.blocks[0].nodes[0].text = '';
+    childrenListBlock.children[0].children[0].text = '';
     expect(listBlock.isNotEmpty()).toEqual(true);
   });
   it('getLastNode should work as expect', () => {
@@ -171,6 +171,6 @@ describe('number list', () => {
         },
       ],
     });
-    expect(listBlock.getLastNode()).toEqual(listBlock.blocks[0].nodes[1]);
+    expect(listBlock.getLastNode()).toEqual(listBlock.children[0].children[1]);
   });
 });

package/dist/collection/components/vega-rich-text-editor/test/dto/blocks/list-item.test.js

@@ -4,7 +4,7 @@ describe('bullet list item', () => {
   it('new RTEBulletListItemBlock should work as expect', () => {
     const bulletListItemBlock = new RTEListItemBlock('1');
     const textNode = new RTETextNode('1', 'This is a text.', bulletListItemBlock);
-    bulletListItemBlock.nodes = [textNode];
+    bulletListItemBlock.children = [textNode];
     expect(bulletListItemBlock).toBeDefined();
   });
   it('from method should work as expect', () => {
@@ -145,7 +145,7 @@ describe('bullet list item', () => {
         },
       ],
     });
-    expect(listItemBlock.getLastNode()).toEqual(listItemBlock.nodes[1]);
+    expect(listItemBlock.getLastNode()).toEqual(listItemBlock.children[1]);
   });
   it('getLastNode should work as expect with children', () => {
     const listItemBlock = RTEListItemBlock.from({
@@ -183,6 +183,6 @@ describe('bullet list item', () => {
         },
       ],
     });
-    expect(listItemBlock.getLastNode()).toEqual(listItemBlock.children[0].blocks[0].nodes[1]);
+    expect(listItemBlock.getLastNode()).toEqual(listItemBlock.nestList[0].children[0].children[1]);
   });
 });

package/dist/collection/components/vega-rich-text-editor/test/dto/blocks/text-block.test.js

@@ -6,7 +6,7 @@ describe('text block', () => {
   it('new RTETextBlock should work as expect', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
-    textBlock.nodes = [textNode];
+    textBlock.children = [textNode];
     expect(textBlock.toJSON()).toEqual({
       id: 'block-1',
       type: 'paragraph',
@@ -82,7 +82,7 @@ describe('text block', () => {
   it('apply method should work as expect', () => {
     const titleBlock = new RTETextBlock('block-1', 'title');
     const textNode = new RTETextNode('1', 'This is a text.', titleBlock);
-    titleBlock.nodes = [textNode];
+    titleBlock.children = [textNode];
     const mockDiv = document.createElement('div');
     const mockHost = document.createElement('div');
     const mockSpan = document.createElement('span');
@@ -126,7 +126,7 @@ describe('text block', () => {
   it('isNotEmpty should work as expect', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
-    textBlock.nodes = [textNode];
+    textBlock.children = [textNode];
     expect(textBlock.isNotEmpty()).toEqual(true);
     textNode.text = '';
     expect(textBlock.isNotEmpty()).toEqual(false);

package/dist/collection/components/vega-rich-text-editor/test/dto/content-state.test.js

@@ -19,45 +19,45 @@ describe('content state', () => {
         type: 'paragraph',
         nodes: [{ id: '1-1', type: 'text', text: 'This is a paragraph' }],
       },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       { id: '2', type: 'title', nodes: [{ id: '2-1', type: 'text', text: 'This is a title' }] },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '3',
         type: 'subtitle',
         nodes: [{ id: '3-1', type: 'text', text: 'This is a subtitle' }],
       },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '4',
         type: 'heading-1',
         nodes: [{ id: '4-1', type: 'text', text: 'This is a heading-1' }],
       },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '5',
         type: 'heading-2',
         nodes: [{ id: '5-1', type: 'text', text: 'This is a heading-2' }],
       },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '6',
         type: 'heading-3',
         nodes: [{ id: '6-1', type: 'text', text: 'This is a heading-3' }],
       },
-    ]).blocks[0] instanceof RTETextBlock).toBeTruthy();
+    ]).children[0] instanceof RTETextBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '7',
         type: 'image',
         nodes: [{ id: '7-1', type: 'image', url: 'mock-url' }],
       },
-    ]).blocks[0] instanceof RTEImageBlock).toBeTruthy();
+    ]).children[0] instanceof RTEImageBlock).toBeTruthy();
     expect(VegaRTEContent.fromJSON([
       {
         id: '8',
@@ -76,7 +76,7 @@ describe('content state', () => {
           },
         ],
       },
-    ]).blocks[0] instanceof RTEListBlock).toBeTruthy();
+    ]).children[0] instanceof RTEListBlock).toBeTruthy();
   });
   it('toJSON method should work as expect', () => {
     expect(VegaRTEContent.fromJSON([
@@ -143,12 +143,12 @@ describe('content state', () => {
     const clonedContentState = contentState.clone(true);
     expect(clonedContentState).not.toBe(contentState);
     expect(clonedContentState).toEqual(contentState);
-    const block = contentState.blocks[0];
-    const clonedBlock = clonedContentState.blocks[0];
+    const block = contentState.children[0];
+    const clonedBlock = clonedContentState.children[0];
     expect(clonedBlock).toEqual(block);
     expect(clonedBlock).not.toBe(block);
-    const node = block.nodes[0];
-    const clonedNode = clonedBlock.nodes[0];
+    const node = block.children[0];
+    const clonedNode = clonedBlock.children[0];
     expect(clonedNode).toEqual(node);
     expect(clonedNode).not.toBe(node);
     const blockAnnotations = block.annotationMap;
@@ -195,12 +195,12 @@ describe('content state', () => {
         ],
       },
     ]);
-    const paragraphBlock = contentState.blocks[0];
-    const imageBlock = contentState.blocks[1];
-    const listBlock = contentState.blocks[2];
-    const listItemBlock = listBlock.blocks[0];
-    const nestedListBlock = listItemBlock.children[0];
-    const nestedListItemBlock = nestedListBlock.blocks[0];
+    const paragraphBlock = contentState.children[0];
+    const imageBlock = contentState.children[1];
+    const listBlock = contentState.children[2];
+    const listItemBlock = listBlock.children[0];
+    const nestedListBlock = listItemBlock.nestList[0];
+    const nestedListItemBlock = nestedListBlock.children[0];
     expect(paragraphBlock.parent).toEqual(contentState);
     expect(imageBlock.parent).toEqual(contentState);
     expect(listBlock.parent).toEqual(contentState);

package/dist/collection/components/vega-rich-text-editor/test/dto/nodes/text-node.test.js

@@ -20,9 +20,9 @@ describe('text node', () => {
   it('new RTETextNode should work as expect', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
-    textBlock.nodes = [textNode];
+    textBlock.children = [textNode];
     expect(textNode.toJSON()).toEqual({ id: '1', text: 'This is a text.', type: 'text' });
-    expect(textNode.parentBlock).toBe(textBlock);
+    expect(textNode.parent).toBe(textBlock);
   });
   it('from method should work as expect', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
@@ -131,7 +131,7 @@ describe('text node', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', 'This is a text 2.', textBlock);
-    textBlock.nodes = [textNode, textNode2];
+    textBlock.children = [textNode, textNode2];
     stateEntityRenderingRegistry.register(mockSpan, textNode);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
     textNode.apply(new SelectionChangeAction(range));
@@ -182,7 +182,7 @@ describe('text node', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', 'This is a text 2.', textBlock);
-    textBlock.nodes = [textNode, textNode2];
+    textBlock.children = [textNode, textNode2];
     stateEntityRenderingRegistry.register(mockSpan, textNode);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
     textNode.apply(new SelectionChangeAction(range));
@@ -221,7 +221,7 @@ describe('text node', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', 'This is a text 2.', textBlock);
-    textBlock.nodes = [textNode, textNode2];
+    textBlock.children = [textNode, textNode2];
     stateEntityRenderingRegistry.register(mockSpan, textNode);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
     textNode.apply(new SelectionChangeAction(range));
@@ -263,7 +263,7 @@ describe('text node', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', '', textBlock);
-    textBlock.nodes = [textNode, textNode2];
+    textBlock.children = [textNode, textNode2];
     stateEntityRenderingRegistry.register(mockSpan, textNode);
     stateEntityRenderingRegistry.register(mockSpan2, textNode2);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
@@ -303,7 +303,7 @@ describe('text node', () => {
     const textBlock = new RTETextBlock('block-1', 'paragraph');
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', 'This is a text 2.', textBlock);
-    textBlock.nodes = [textNode, textNode2];
+    textBlock.children = [textNode, textNode2];
     stateEntityRenderingRegistry.register(mockSpan, textNode);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
     textNode.apply(new SelectionChangeAction(range));
@@ -348,12 +348,12 @@ describe('text node', () => {
     const textNode = new RTETextNode('1', 'This is a text.', textBlock);
     const textNode2 = new RTETextNode('2', 'This is a text 2.', textBlock);
     const textNode3 = new RTETextNode('3', 'This is a text 3.', textBlock);
-    textBlock.nodes = [textNode, textNode2, textNode3];
+    textBlock.children = [textNode, textNode2, textNode3];
     stateEntityRenderingRegistry.register(mockSpan1, textNode);
     stateEntityRenderingRegistry.register(mockSpan2, textNode2);
     stateEntityRenderingRegistry.register(mockSpan3, textNode3);
     stateEntityRenderingRegistry.register(mockDiv, textBlock);
-    textBlock.nodes.forEach((node) => {
+    textBlock.children.forEach((node) => {
       node.apply(new SelectionChangeAction(range));
       node.apply(new BoldAnnotationAction(true));
     });

package/dist/collection/components/vega-table/slimmers/controllers/dto/column-render-input-model.js

@@ -0,0 +1,216 @@
+/**
+ * ColumnRenderInputModel
+ *
+ * Render-time representation of a column or group node used by header/body renderers.
+ * Built from a ColumnStructureModel tree, it carries computed layout metadata required
+ * for rendering and pinned/sticky calculations (colSpan, rowSpan, pinned boundaries, etc).
+ *
+ * Instances form a forest (root-level nodes in an array) that mirrors the structure model
+ * but contains additional render-specific properties and parent/child links for renderers.
+ */
+export class ColumnRenderInputModel {
+  /**
+   * Create a new render input node.
+   *
+   * @param {string} key - Unique key (matches ColumnStructureModel.key).
+   * @param {string} label - Optional display label (from structure model).
+   * @param {VegaTablePinnedType} pinned - Pinned type for this node ('left' | 'right' | null).
+   * @param {Nullable<number>} colSpan - Number of visual columns spanned by this node's subtree.
+   * @param {Nullable<number>} rowSpan - Number of header rows this node should span.
+   * @param {boolean} isViewStart - True when this node is the start of a visible view range.
+   * @param {boolean} isViewEnd - True when this node is the end of a visible view range.
+   * @param {boolean} isLeftEndPinned - True when node is last left-pinned sibling.
+   * @param {boolean} isRightStartPinned - True when node is first right-pinned sibling.
+   * @param {boolean} isNoPinnedEnd - True when node is last non-pinned sibling.
+   * @param {boolean} headHasGroupColumn - Header contains group columns (affects rowSpan).
+   * @param {boolean} headHasPinnedColumn - Header contains pinned columns.
+   * @param {number} headMaxDepth - Maximum header depth (number of header rows).
+   * @param {number} level - Level/index of this node within header rows (0-based).
+   * @param {number} columnIndex - Sequential leaf index (used for ordering).
+   * @param {Nullable<ColumnRenderInputModel>} parent - Parent render input node (null for root-level).
+   * @param {ColumnRenderInputModel[]} children - Child render input nodes.
+   */
+  constructor(key, label, pinned, colSpan, rowSpan, isViewStart, isViewEnd, isLeftEndPinned, isRightStartPinned, isNoPinnedEnd, headHasGroupColumn, headHasPinnedColumn, headMaxDepth, level, columnIndex, parent, children = []) {
+    this.key = key;
+    this.label = label;
+    this.pinned = pinned;
+    this.colSpan = colSpan;
+    this.rowSpan = rowSpan;
+    this.isViewStart = isViewStart;
+    this.isViewEnd = isViewEnd;
+    this.isLeftEndPinned = isLeftEndPinned;
+    this.isRightStartPinned = isRightStartPinned;
+    this.isNoPinnedEnd = isNoPinnedEnd;
+    this.headHasGroupColumn = headHasGroupColumn;
+    this.headHasPinnedColumn = headHasPinnedColumn;
+    this.headMaxDepth = headMaxDepth;
+    this.level = level;
+    this.columnIndex = columnIndex;
+    this.parent = parent;
+    this.children = children;
+    this.iteratorCacheMap = new Map();
+    this.leaves = [];
+  }
+  /**
+   * Build a forest of ColumnRenderInputModel nodes from a ColumnStructureModel root.
+   *
+   * @param {ColumnStructureModel} rootModel - Root ColumnStructureModel that supplies tree and level data.
+   * @returns {ColumnRenderInputModel[]} Array of root-level ColumnRenderInputModel nodes (the render forest).
+   */
+  static from(rootModel) {
+    const renderInputs = [];
+    const parentStack = [];
+    const maxLevel = rootModel.getMaxDepth();
+    const hasGroupColumn = rootModel.hasGroupColumn();
+    const hasPinnedColumn = rootModel.hasLeftPinnedColumn() || rootModel.hasRightPinnedColumn();
+    let columnIndex = 0;
+    // Iterate structure model (DFS by default) and construct render nodes.
+    rootModel.iterator().forEach((model) => {
+      const parent = model.level > 0 ? parentStack[model.level - 1] : null;
+      const isParentStart = hasGroupColumn && this.isParentStart(model);
+      const isParentEnd = hasGroupColumn && this.isParentEnd(model);
+      const renderInput = new ColumnRenderInputModel(model.key, model.label, parent ? parent.pinned : model.pinned, hasGroupColumn ? this.getColSpan(model) : null, hasGroupColumn ? (model.isLeaf() ? maxLevel - model.level : 1) : null, parent ? parent.isViewStart && isParentStart : isParentStart, parent ? parent.isViewEnd && isParentEnd : isParentEnd, parent
+        ? parent.isLeftEndPinned && isParentEnd
+        : hasPinnedColumn && this.isLeftEndPinned(model), parent
+        ? parent.isRightStartPinned && isParentStart
+        : hasPinnedColumn && this.isRightStartPinned(model), parent ? parent.isNoPinnedEnd && isParentEnd : hasPinnedColumn && this.isNoPinnedEnd(model), hasGroupColumn, hasPinnedColumn, maxLevel, model.level, columnIndex, parent);
+      // Attach to parent if present, otherwise add to root-level array.
+      parent ? parent.children.push(renderInput) : renderInputs.push(renderInput);
+      // Maintain parent stack keyed by level to allow next nodes to find their parent.
+      parentStack[model.level] = renderInput;
+      parentStack.length = model.level + 1;
+      // Increment leaf index when encountering a leaf structure node.
+      if (model.isLeaf())
+        columnIndex++;
+    });
+    return renderInputs;
+  }
+  /**
+   * True when the provided structure model is the last left-pinned sibling in its parent's children.
+   * Used to mark boundary nodes for left-pinned groups.
+   *
+   * @param {ColumnStructureModel} model - Structure model to check.
+   * @returns {boolean} True when model is the last left-pinned sibling.
+   */
+  static isLeftEndPinned(model) {
+    const siblings = model.parent
+      .getOrderedChildren()
+      .filter((child) => child.pinned === 'left');
+    return siblings[siblings.length - 1] === model;
+  }
+  /**
+   * True when the provided structure model is the first right-pinned sibling in its parent's children.
+   * Used to mark boundary nodes for right-pinned groups.
+   *
+   * @param {ColumnStructureModel} model - Structure model to check.
+   * @returns {boolean} True when model is the first right-pinned sibling.
+   */
+  static isRightStartPinned(model) {
+    const siblings = model.parent
+      .getOrderedChildren()
+      .filter((child) => child.pinned === 'right');
+    return siblings[0] === model;
+  }
+  /**
+   * True when the provided structure model is the last non-pinned sibling in its parent's children.
+   * Useful to handle the 'no-pinned-end' condition.
+   *
+   * @param {ColumnStructureModel} model - Structure model to check.
+   * @returns {boolean} True when model is the last non-pinned sibling.
+   */
+  static isNoPinnedEnd(model) {
+    const siblings = model.parent
+      .getOrderedChildren()
+      .filter((child) => !child.pinned);
+    return siblings[siblings.length - 1] === model;
+  }
+  /**
+   * True when the provided model is the first child of its parent.
+   *
+   * @param {ColumnStructureModel} model - Structure model to check.
+   * @returns {boolean} True when model is the first child.
+   */
+  static isParentStart(model) {
+    return model.parent.getOrderedChildren()[0] === model;
+  }
+  /**
+   * True when the provided model is the last child of its parent.
+   *
+   * @param {ColumnStructureModel} model - Structure model to check.
+   * @returns {boolean} True when model is the last child.
+   */
+  static isParentEnd(model) {
+    const parentChildren = model.parent.getOrderedChildren();
+    return parentChildren[parentChildren.length - 1] === model;
+  }
+  /**
+   * Compute a node's colSpan by iterating its subtree and counting the maximum number
+   * of nodes present at any single level (visual column span).
+   *
+   * @param {ColumnStructureModel} mode - ColumnStructureModel node to examine.
+   * @returns {number} Number of visual columns spanned by the node.
+   */
+  static getColSpan(mode) {
+    const children = mode.iterator();
+    const rowMap = {};
+    children.forEach((node) => {
+      rowMap[node.level] = (rowMap[node.level] || 0) + 1;
+    });
+    return Math.max(...Object.values(rowMap));
+  }
+  /**
+   * Return cached leaf render nodes for this subtree.
+   * Caches the result on first call and returns cached array on subsequent calls.
+   *
+   * @returns {ColumnRenderInputModel[]} Array of leaf render input nodes.
+   */
+  getLeaves() {
+    if (this.leaves.length > 0) {
+      return this.leaves;
+    }
+    const leaves = this.iterator().filter((model) => model.isLeaf());
+    this.leaves = leaves;
+    return leaves;
+  }
+  /**
+   * Generic iterator that supports traversal modes ('dfs' currently implemented).
+   *
+   * @param {IteratorMode} [mode='dfs'] - Iterator mode ('dfs' | 'bfs').
+   * @returns {ColumnRenderInputModel[]} Traversal-ordered array of nodes.
+   */
+  iterator(mode = 'dfs') {
+    if (mode === 'dfs') {
+      return this.dfsIterator();
+    }
+    // Future: implement BFS mode here.
+    return [];
+  }
+  /**
+   * Depth-first pre-order traversal of this node and its descendants.
+   * Caches the result for the 'dfs' mode to avoid repeated recursion.
+   *
+   * @returns {ColumnRenderInputModel[]} Array of nodes in DFS order (includes this node).
+   */
+  dfsIterator() {
+    if (this.iteratorCacheMap.has('dfs')) {
+      return this.iteratorCacheMap.get('dfs');
+    }
+    const localResult = [];
+    localResult.push(this);
+    if (this.children && this.children.length > 0) {
+      this.children.forEach((child) => {
+        localResult.push(...child.dfsIterator());
+      });
+    }
+    this.iteratorCacheMap.set('dfs', localResult);
+    return localResult;
+  }
+  /**
+   * True when this render node has no children (visual leaf).
+   *
+   * @returns {boolean} True when node is a leaf.
+   */
+  isLeaf() {
+    return !this.children || this.children.length === 0;
+  }
+}