@cube-dev/ui-kit 0.143.1 → 0.144.0

package/dist/components/layout/Board/grid-core/layout.js

@@ -0,0 +1,176 @@
+/** @license MIT | @cube-dev/ui-kit v0.144.0 | Cube Dev Team */
+import { getAllCollisions, getFirstCollision } from "./collision.js";
+import { sortLayoutItems } from "./sort.js";
+
+//#region src/components/layout/Board/grid-core/layout.ts
+/**
+* Core layout manipulation utilities.
+*
+* Vendored from react-grid-layout v2 (`src/core/layout.ts`).
+* See ./NOTICE.md for attribution and license.
+*
+* These functions create, modify, and query grid layouts. Most functions treat
+* layouts as immutable and return new arrays/objects, but a few mutate items in
+* place for performance (documented per function).
+*/
+/**
+* Get the bottom-most Y coordinate of the layout (max of y + h).
+*/
+function bottom(layout) {
+	let max = 0;
+	for (let i = 0; i < layout.length; i++) {
+		const item = layout[i];
+		if (item !== void 0) {
+			const bottomY = item.y + item.h;
+			if (bottomY > max) max = bottomY;
+		}
+	}
+	return max;
+}
+/** Get a layout item by its ID. */
+function getLayoutItem(layout, id) {
+	for (let i = 0; i < layout.length; i++) {
+		const item = layout[i];
+		if (item !== void 0 && item.i === id) return item;
+	}
+}
+/** Get all static items from the layout. */
+function getStatics(layout) {
+	return layout.filter((l) => l.static === true);
+}
+/** Clone a layout item (shallow copy, boolean flags normalized). */
+function cloneLayoutItem(layoutItem) {
+	return {
+		i: layoutItem.i,
+		x: layoutItem.x,
+		y: layoutItem.y,
+		w: layoutItem.w,
+		h: layoutItem.h,
+		minW: layoutItem.minW,
+		maxW: layoutItem.maxW,
+		minH: layoutItem.minH,
+		maxH: layoutItem.maxH,
+		moved: Boolean(layoutItem.moved),
+		static: Boolean(layoutItem.static),
+		isDraggable: layoutItem.isDraggable,
+		isResizable: layoutItem.isResizable,
+		resizeHandles: layoutItem.resizeHandles,
+		constraints: layoutItem.constraints,
+		isBounded: layoutItem.isBounded
+	};
+}
+/** Clone an entire layout. */
+function cloneLayout(layout) {
+	const newLayout = new Array(layout.length);
+	for (let i = 0; i < layout.length; i++) {
+		const item = layout[i];
+		if (item !== void 0) newLayout[i] = cloneLayoutItem(item);
+	}
+	return newLayout;
+}
+/** Replace a layout item in a layout (matched by `i`). Other items untouched. */
+function modifyLayout(layout, layoutItem) {
+	const newLayout = new Array(layout.length);
+	for (let i = 0; i < layout.length; i++) {
+		const item = layout[i];
+		if (item !== void 0) if (layoutItem.i === item.i) newLayout[i] = layoutItem;
+		else newLayout[i] = item;
+	}
+	return newLayout;
+}
+/**
+* Ensure all layout items fit within the grid bounds.
+*
+* **IMPORTANT**: mutates the layout items in place for performance. Clone the
+* layout first (e.g. with `cloneLayout()`) if you need immutability.
+*/
+function correctBounds(layout, bounds) {
+	const collidesWith = getStatics(layout);
+	for (let i = 0; i < layout.length; i++) {
+		const l = layout[i];
+		if (l === void 0) continue;
+		if (l.x + l.w > bounds.cols) l.x = bounds.cols - l.w;
+		if (l.x < 0) {
+			l.x = 0;
+			l.w = bounds.cols;
+		}
+		if (!l.static) collidesWith.push(l);
+		else while (getFirstCollision(collidesWith, l)) l.y++;
+	}
+	return layout;
+}
+/**
+* Move a layout element to a new position.
+*
+* Handles collision detection and cascading movements. Does not compact the
+* layout - call the compactor separately.
+*
+* **Note**: mutates the `l` parameter directly for performance.
+*/
+function moveElement(layout, l, x, y, isUserAction, preventCollision, compactType, cols, allowOverlap) {
+	if (l.static && l.isDraggable !== true) return [...layout];
+	if (l.y === y && l.x === x) return [...layout];
+	const oldX = l.x;
+	const oldY = l.y;
+	if (typeof x === "number") l.x = x;
+	if (typeof y === "number") l.y = y;
+	l.moved = true;
+	let sorted = sortLayoutItems(layout, compactType);
+	if (compactType === "vertical" && typeof y === "number" ? oldY >= y : compactType === "horizontal" && typeof x === "number" ? oldX >= x : false) sorted = sorted.reverse();
+	const collisions = getAllCollisions(sorted, l);
+	const hasCollisions = collisions.length > 0;
+	if (hasCollisions && allowOverlap) return cloneLayout(layout);
+	if (hasCollisions && preventCollision) {
+		l.x = oldX;
+		l.y = oldY;
+		l.moved = false;
+		return layout;
+	}
+	let resultLayout = [...layout];
+	for (let i = 0; i < collisions.length; i++) {
+		const collision = collisions[i];
+		if (collision === void 0) continue;
+		if (collision.moved) continue;
+		if (collision.static) resultLayout = moveElementAwayFromCollision(resultLayout, collision, l, isUserAction, compactType, cols);
+		else resultLayout = moveElementAwayFromCollision(resultLayout, l, collision, isUserAction, compactType, cols);
+	}
+	return resultLayout;
+}
+/**
+* Move an item away from a collision. Attempts to move up/left first if there's
+* room, otherwise moves it down/right.
+*/
+function moveElementAwayFromCollision(layout, collidesWith, itemToMove, isUserAction, compactType, cols) {
+	const compactH = compactType === "horizontal";
+	const compactV = compactType === "vertical";
+	const preventCollision = collidesWith.static;
+	if (isUserAction) {
+		isUserAction = false;
+		const fakeItem = {
+			x: compactH ? Math.max(collidesWith.x - itemToMove.w, 0) : itemToMove.x,
+			y: compactV ? Math.max(collidesWith.y - itemToMove.h, 0) : itemToMove.y,
+			w: itemToMove.w,
+			h: itemToMove.h,
+			i: "-1"
+		};
+		const firstCollision = getFirstCollision(layout, fakeItem);
+		const collisionNorth = firstCollision !== void 0 && firstCollision.y + firstCollision.h > collidesWith.y;
+		const collisionWest = firstCollision !== void 0 && collidesWith.x + collidesWith.w > firstCollision.x;
+		if (!firstCollision) return moveElement(layout, itemToMove, compactH ? fakeItem.x : void 0, compactV ? fakeItem.y : void 0, isUserAction, preventCollision, compactType, cols);
+		if (collisionNorth && compactV) return moveElement(layout, itemToMove, void 0, itemToMove.y + 1, isUserAction, preventCollision, compactType, cols);
+		if (collisionNorth && compactType === null) {
+			collidesWith.y = itemToMove.y;
+			itemToMove.y = itemToMove.y + itemToMove.h;
+			return [...layout];
+		}
+		if (collisionWest && compactH) return moveElement(layout, collidesWith, itemToMove.x, void 0, isUserAction, preventCollision, compactType, cols);
+	}
+	const newX = compactH ? itemToMove.x + 1 : void 0;
+	const newY = compactV ? itemToMove.y + 1 : void 0;
+	if (newX === void 0 && newY === void 0) return [...layout];
+	return moveElement(layout, itemToMove, newX, newY, isUserAction, preventCollision, compactType, cols);
+}
+
+//#endregion
+export { bottom, cloneLayout, cloneLayoutItem, correctBounds, getLayoutItem, getStatics, modifyLayout, moveElement };
+//# sourceMappingURL=layout.js.map

package/dist/components/layout/Board/grid-core/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","names":[],"sources":["../../../../../src/components/layout/Board/grid-core/layout.ts"],"sourcesContent":["/**\n * Core layout manipulation utilities.\n *\n * Vendored from react-grid-layout v2 (`src/core/layout.ts`).\n * See ./NOTICE.md for attribution and license.\n *\n * These functions create, modify, and query grid layouts. Most functions treat\n * layouts as immutable and return new arrays/objects, but a few mutate items in\n * place for performance (documented per function).\n */\n\nimport { getAllCollisions, getFirstCollision } from './collision';\nimport { sortLayoutItems } from './sort';\n\nimport type { CompactType, Layout, LayoutItem, Mutable } from './types';\n\n// ============================================================================\n// Layout Queries\n// ============================================================================\n\n/**\n * Get the bottom-most Y coordinate of the layout (max of y + h).\n */\nexport function bottom(layout: Layout): number {\n  let max = 0;\n  for (let i = 0; i < layout.length; i++) {\n    const item = layout[i];\n    if (item !== undefined) {\n      const bottomY = item.y + item.h;\n      if (bottomY > max) max = bottomY;\n    }\n  }\n  return max;\n}\n\n/** Get a layout item by its ID. */\nexport function getLayoutItem(\n  layout: Layout,\n  id: string,\n): LayoutItem | undefined {\n  for (let i = 0; i < layout.length; i++) {\n    const item = layout[i];\n    if (item !== undefined && item.i === id) {\n      return item;\n    }\n  }\n  return undefined;\n}\n\n/** Get all static items from the layout. */\nexport function getStatics(layout: Layout): LayoutItem[] {\n  return layout.filter((l): l is LayoutItem => l.static === true);\n}\n\n// ============================================================================\n// Layout Cloning\n// ============================================================================\n\n/** Clone a layout item (shallow copy, boolean flags normalized). */\nexport function cloneLayoutItem(layoutItem: LayoutItem): LayoutItem {\n  return {\n    i: layoutItem.i,\n    x: layoutItem.x,\n    y: layoutItem.y,\n    w: layoutItem.w,\n    h: layoutItem.h,\n    minW: layoutItem.minW,\n    maxW: layoutItem.maxW,\n    minH: layoutItem.minH,\n    maxH: layoutItem.maxH,\n    moved: Boolean(layoutItem.moved),\n    static: Boolean(layoutItem.static),\n    isDraggable: layoutItem.isDraggable,\n    isResizable: layoutItem.isResizable,\n    resizeHandles: layoutItem.resizeHandles,\n    constraints: layoutItem.constraints,\n    isBounded: layoutItem.isBounded,\n  };\n}\n\n/** Clone an entire layout. */\nexport function cloneLayout(layout: Layout): LayoutItem[] {\n  const newLayout: LayoutItem[] = new Array(layout.length);\n  for (let i = 0; i < layout.length; i++) {\n    const item = layout[i];\n    if (item !== undefined) {\n      newLayout[i] = cloneLayoutItem(item);\n    }\n  }\n  return newLayout;\n}\n\n// ============================================================================\n// Layout Modification\n// ============================================================================\n\n/** Replace a layout item in a layout (matched by `i`). Other items untouched. */\nexport function modifyLayout(\n  layout: Layout,\n  layoutItem: LayoutItem,\n): LayoutItem[] {\n  const newLayout: LayoutItem[] = new Array(layout.length);\n  for (let i = 0; i < layout.length; i++) {\n    const item = layout[i];\n    if (item !== undefined) {\n      if (layoutItem.i === item.i) {\n        newLayout[i] = layoutItem;\n      } else {\n        newLayout[i] = item;\n      }\n    }\n  }\n  return newLayout;\n}\n\n/**\n * Apply a transformation to a layout item. Finds the item by key, clones it,\n * applies the callback, and returns [new layout, modified item | null].\n */\nexport function withLayoutItem(\n  layout: Layout,\n  itemKey: string,\n  cb: (item: LayoutItem) => LayoutItem,\n): [LayoutItem[], LayoutItem | null] {\n  let item = getLayoutItem(layout, itemKey);\n  if (!item) {\n    return [[...layout], null];\n  }\n\n  item = cb(cloneLayoutItem(item));\n  const newLayout = modifyLayout(layout, item);\n\n  return [newLayout, item];\n}\n\n// ============================================================================\n// Bounds Correction\n// ============================================================================\n\n/**\n * Ensure all layout items fit within the grid bounds.\n *\n * **IMPORTANT**: mutates the layout items in place for performance. Clone the\n * layout first (e.g. with `cloneLayout()`) if you need immutability.\n */\nexport function correctBounds(\n  layout: Mutable<LayoutItem>[],\n  bounds: { cols: number },\n): LayoutItem[] {\n  const collidesWith = getStatics(layout);\n\n  for (let i = 0; i < layout.length; i++) {\n    const l = layout[i];\n    if (l === undefined) continue;\n\n    // Overflows right\n    if (l.x + l.w > bounds.cols) {\n      l.x = bounds.cols - l.w;\n    }\n\n    // Overflows left\n    if (l.x < 0) {\n      l.x = 0;\n      l.w = bounds.cols;\n    }\n\n    if (!l.static) {\n      collidesWith.push(l);\n    } else {\n      // Static items that collide with other statics must be moved down\n      while (getFirstCollision(collidesWith, l)) {\n        l.y++;\n      }\n    }\n  }\n\n  return layout;\n}\n\n// ============================================================================\n// Move Operations\n// ============================================================================\n\n/**\n * Move a layout element to a new position.\n *\n * Handles collision detection and cascading movements. Does not compact the\n * layout - call the compactor separately.\n *\n * **Note**: mutates the `l` parameter directly for performance.\n */\nexport function moveElement(\n  layout: Layout,\n  l: LayoutItem,\n  x: number | undefined,\n  y: number | undefined,\n  isUserAction: boolean | undefined,\n  preventCollision: boolean | undefined,\n  compactType: CompactType,\n  cols: number,\n  allowOverlap?: boolean,\n): LayoutItem[] {\n  // Static items can't be moved unless explicitly draggable\n  if (l.static && l.isDraggable !== true) {\n    return [...layout];\n  }\n\n  // Short-circuit if position unchanged\n  if (l.y === y && l.x === x) {\n    return [...layout];\n  }\n\n  const oldX = l.x;\n  const oldY = l.y;\n\n  // Update position (mutates l directly - see JSDoc note)\n  if (typeof x === 'number') (l as Mutable<LayoutItem>).x = x;\n  if (typeof y === 'number') (l as Mutable<LayoutItem>).y = y;\n  (l as Mutable<LayoutItem>).moved = true;\n\n  // Sort for proper collision detection order\n  let sorted = sortLayoutItems(layout, compactType);\n  const movingUp =\n    compactType === 'vertical' && typeof y === 'number'\n      ? oldY >= y\n      : compactType === 'horizontal' && typeof x === 'number'\n        ? oldX >= x\n        : false;\n\n  if (movingUp) {\n    sorted = sorted.reverse();\n  }\n\n  const collisions = getAllCollisions(sorted, l);\n  const hasCollisions = collisions.length > 0;\n\n  // Handle overlap mode - just clone and return\n  if (hasCollisions && allowOverlap) {\n    return cloneLayout(layout);\n  }\n\n  // Handle prevent collision mode - revert position.\n  // Return same reference to signal no change occurred.\n  if (hasCollisions && preventCollision) {\n    (l as Mutable<LayoutItem>).x = oldX;\n    (l as Mutable<LayoutItem>).y = oldY;\n    (l as Mutable<LayoutItem>).moved = false;\n    return layout as LayoutItem[];\n  }\n\n  // Resolve collisions by moving other items\n  let resultLayout: LayoutItem[] = [...layout];\n  for (let i = 0; i < collisions.length; i++) {\n    const collision = collisions[i];\n    if (collision === undefined) continue;\n\n    // Skip already-moved items to prevent infinite loops\n    if (collision.moved) continue;\n\n    // Static items can't be moved - move the dragged item instead\n    if (collision.static) {\n      resultLayout = moveElementAwayFromCollision(\n        resultLayout,\n        collision,\n        l,\n        isUserAction,\n        compactType,\n        cols,\n      );\n    } else {\n      resultLayout = moveElementAwayFromCollision(\n        resultLayout,\n        l,\n        collision,\n        isUserAction,\n        compactType,\n        cols,\n      );\n    }\n  }\n\n  return resultLayout;\n}\n\n/**\n * Move an item away from a collision. Attempts to move up/left first if there's\n * room, otherwise moves it down/right.\n */\nexport function moveElementAwayFromCollision(\n  layout: Layout,\n  collidesWith: LayoutItem,\n  itemToMove: LayoutItem,\n  isUserAction: boolean | undefined,\n  compactType: CompactType,\n  cols: number,\n): LayoutItem[] {\n  const compactH = compactType === 'horizontal';\n  const compactV = compactType === 'vertical';\n  const preventCollision = collidesWith.static;\n\n  // Try to move up/left first (only on primary collision from user action)\n  if (isUserAction) {\n    isUserAction = false; // Only try this once\n\n    // Create a fake item to test if there's room above/left\n    const fakeItem: LayoutItem = {\n      x: compactH ? Math.max(collidesWith.x - itemToMove.w, 0) : itemToMove.x,\n      y: compactV ? Math.max(collidesWith.y - itemToMove.h, 0) : itemToMove.y,\n      w: itemToMove.w,\n      h: itemToMove.h,\n      i: '-1',\n    };\n\n    const firstCollision = getFirstCollision(layout, fakeItem);\n    const collisionNorth =\n      firstCollision !== undefined &&\n      firstCollision.y + firstCollision.h > collidesWith.y;\n    const collisionWest =\n      firstCollision !== undefined &&\n      collidesWith.x + collidesWith.w > firstCollision.x;\n\n    // No collision above/left - we can move there\n    if (!firstCollision) {\n      return moveElement(\n        layout,\n        itemToMove,\n        compactH ? fakeItem.x : undefined,\n        compactV ? fakeItem.y : undefined,\n        isUserAction,\n        preventCollision,\n        compactType,\n        cols,\n      );\n    }\n\n    // Handle specific collision cases\n    if (collisionNorth && compactV) {\n      return moveElement(\n        layout,\n        itemToMove,\n        undefined,\n        itemToMove.y + 1,\n        isUserAction,\n        preventCollision,\n        compactType,\n        cols,\n      );\n    }\n\n    if (collisionNorth && compactType === null) {\n      // Swap positions in free-form mode\n      (collidesWith as Mutable<LayoutItem>).y = itemToMove.y;\n      (itemToMove as Mutable<LayoutItem>).y = itemToMove.y + itemToMove.h;\n      return [...layout];\n    }\n\n    if (collisionWest && compactH) {\n      return moveElement(\n        layout,\n        collidesWith,\n        itemToMove.x,\n        undefined,\n        isUserAction,\n        preventCollision,\n        compactType,\n        cols,\n      );\n    }\n  }\n\n  // Default: move down/right by 1\n  const newX = compactH ? itemToMove.x + 1 : undefined;\n  const newY = compactV ? itemToMove.y + 1 : undefined;\n\n  if (newX === undefined && newY === undefined) {\n    return [...layout];\n  }\n\n  return moveElement(\n    layout,\n    itemToMove,\n    newX,\n    newY,\n    isUserAction,\n    preventCollision,\n    compactType,\n    cols,\n  );\n}\n\n// ============================================================================\n// Validation\n// ============================================================================\n\n/** Validate that a layout has the required numeric properties. */\nexport function validateLayout(\n  layout: Layout,\n  contextName: string = 'Layout',\n): void {\n  const requiredProps = ['x', 'y', 'w', 'h'] as const;\n\n  if (!Array.isArray(layout)) {\n    throw new Error(`${contextName} must be an array!`);\n  }\n\n  for (let i = 0; i < layout.length; i++) {\n    const item = layout[i];\n    if (item === undefined) continue;\n\n    for (const key of requiredProps) {\n      const value = item[key];\n      if (typeof value !== 'number' || Number.isNaN(value)) {\n        throw new Error(\n          `Board: ${contextName}[${i}].${key} must be a number! ` +\n            `Received: ${String(value)} (${typeof value})`,\n        );\n      }\n    }\n\n    if (item.i !== undefined && typeof item.i !== 'string') {\n      throw new Error(\n        `Board: ${contextName}[${i}].i must be a string! ` +\n          `Received: ${String(item.i)} (${typeof item.i})`,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/components/layout/Board/grid-core/sort.js

@@ -0,0 +1,37 @@
+/** @license MIT | @cube-dev/ui-kit v0.144.0 | Cube Dev Team */
+//#region src/components/layout/Board/grid-core/sort.ts
+/**
+* Sort layout items based on the compaction type.
+*
+* - Vertical compaction: sort by row (y) then column (x)
+* - Horizontal compaction: sort by column (x) then row (y)
+* - No compaction (null): return original order
+*/
+function sortLayoutItems(layout, compactType) {
+	if (compactType === "horizontal") return sortLayoutItemsByColRow(layout);
+	if (compactType === "vertical") return sortLayoutItemsByRowCol(layout);
+	if (compactType === "wrap") return sortLayoutItemsByRowCol(layout);
+	return [...layout];
+}
+/**
+* Sort layout items by row ascending, then column ascending.
+*/
+function sortLayoutItemsByRowCol(layout) {
+	return [...layout].sort((a, b) => {
+		if (a.y !== b.y) return a.y - b.y;
+		return a.x - b.x;
+	});
+}
+/**
+* Sort layout items by column ascending, then row ascending.
+*/
+function sortLayoutItemsByColRow(layout) {
+	return [...layout].sort((a, b) => {
+		if (a.x !== b.x) return a.x - b.x;
+		return a.y - b.y;
+	});
+}
+
+//#endregion
+export { sortLayoutItems, sortLayoutItemsByColRow, sortLayoutItemsByRowCol };
+//# sourceMappingURL=sort.js.map

package/dist/components/layout/Board/grid-core/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","names":[],"sources":["../../../../../src/components/layout/Board/grid-core/sort.ts"],"sourcesContent":["/**\n * Sorting utilities for grid layouts.\n *\n * Vendored from react-grid-layout v2 (`src/core/sort.ts`).\n * See ./NOTICE.md for attribution and license.\n */\n\nimport type { CompactType, Layout, LayoutItem } from './types';\n\n/**\n * Sort layout items based on the compaction type.\n *\n * - Vertical compaction: sort by row (y) then column (x)\n * - Horizontal compaction: sort by column (x) then row (y)\n * - No compaction (null): return original order\n */\nexport function sortLayoutItems(\n  layout: Layout,\n  compactType: CompactType,\n): LayoutItem[] {\n  if (compactType === 'horizontal') {\n    return sortLayoutItemsByColRow(layout);\n  }\n  if (compactType === 'vertical') {\n    return sortLayoutItemsByRowCol(layout);\n  }\n  if (compactType === 'wrap') {\n    // Wrap mode uses row-col order (reading order: left-to-right, top-to-bottom)\n    return sortLayoutItemsByRowCol(layout);\n  }\n  // No compaction - return a copy to maintain immutability\n  return [...layout];\n}\n\n/**\n * Sort layout items by row ascending, then column ascending.\n */\nexport function sortLayoutItemsByRowCol(layout: Layout): LayoutItem[] {\n  return [...layout].sort((a, b) => {\n    if (a.y !== b.y) {\n      return a.y - b.y;\n    }\n    return a.x - b.x;\n  });\n}\n\n/**\n * Sort layout items by column ascending, then row ascending.\n */\nexport function sortLayoutItemsByColRow(layout: Layout): LayoutItem[] {\n  return [...layout].sort((a, b) => {\n    if (a.x !== b.x) {\n      return a.x - b.x;\n    }\n    return a.y - b.y;\n  });\n}\n"],"mappings":";;;;;;;;;AAgBA,SAAgB,gBACd,QACA,aACc;AACd,KAAI,gBAAgB,aAClB,QAAO,wBAAwB,OAAO;AAExC,KAAI,gBAAgB,WAClB,QAAO,wBAAwB,OAAO;AAExC,KAAI,gBAAgB,OAElB,QAAO,wBAAwB,OAAO;AAGxC,QAAO,CAAC,GAAG,OAAO;;;;;AAMpB,SAAgB,wBAAwB,QAA8B;AACpE,QAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM;AAChC,MAAI,EAAE,MAAM,EAAE,EACZ,QAAO,EAAE,IAAI,EAAE;AAEjB,SAAO,EAAE,IAAI,EAAE;GACf;;;;;AAMJ,SAAgB,wBAAwB,QAA8B;AACpE,QAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM;AAChC,MAAI,EAAE,MAAM,EAAE,EACZ,QAAO,EAAE,IAAI,EAAE;AAEjB,SAAO,EAAE,IAAI,EAAE;GACf"}

package/dist/components/layout/Board/grid-core/types.d.ts

@@ -0,0 +1,168 @@
+
+//#region src/components/layout/Board/grid-core/types.d.ts
+/**
+ * Core types for the grid layout engine.
+ *
+ * Vendored and trimmed from react-grid-layout v2 (`src/core/types.ts`).
+ * See ./NOTICE.md for attribution and license.
+ *
+ * These types are framework-agnostic and describe the data structures used by
+ * the layout algorithms.
+ */
+/**
+ * Axis identifiers for resize handles.
+ * - Cardinal: 'n', 's', 'e', 'w' (north, south, east, west)
+ * - Diagonal: 'ne', 'nw', 'se', 'sw'
+ */
+type ResizeHandleAxis = 's' | 'w' | 'e' | 'n' | 'sw' | 'nw' | 'se' | 'ne';
+/**
+ * A single item in the grid layout.
+ *
+ * Position (x, y) is in grid units, not pixels. Size (w, h) is in grid units.
+ */
+interface LayoutItem {
+  /** Unique identifier for this item */
+  i: string;
+  /** X position in grid units (0-indexed from left) */
+  x: number;
+  /** Y position in grid units (0-indexed from top) */
+  y: number;
+  /** Width in grid units */
+  w: number;
+  /** Height in grid units */
+  h: number;
+  /** Minimum width in grid units */
+  minW?: number;
+  /** Minimum height in grid units */
+  minH?: number;
+  /** Maximum width in grid units */
+  maxW?: number;
+  /** Maximum height in grid units */
+  maxH?: number;
+  /**
+   * If true, item cannot be dragged or resized, and other items will move
+   * around it during compaction.
+   */
+  static?: boolean;
+  /**
+   * If false, item cannot be dragged (but may still be resizable).
+   * Overrides grid-level isDraggable for this item.
+   */
+  isDraggable?: boolean;
+  /**
+   * If false, item cannot be resized (but may still be draggable).
+   * Overrides grid-level isResizable for this item.
+   */
+  isResizable?: boolean;
+  /**
+   * Which resize handles to show for this item.
+   * Overrides grid-level resizeHandles for this item.
+   */
+  resizeHandles?: ResizeHandleAxis[];
+  /**
+   * If true, item is constrained to the grid container bounds.
+   * Overrides grid-level isBounded for this item.
+   */
+  isBounded?: boolean;
+  /**
+   * Internal flag set during drag/resize operations to indicate the item has
+   * moved from its original position.
+   * @internal
+   */
+  moved?: boolean;
+  /**
+   * Per-item layout constraints. Applied in addition to grid-level constraints.
+   */
+  constraints?: LayoutConstraint[];
+}
+/**
+ * A layout is a readonly array of layout items. Treat layouts as immutable.
+ */
+type Layout = readonly LayoutItem[];
+/**
+ * Type of compaction to apply to the layout.
+ * - 'vertical': Items compact upward (default)
+ * - 'horizontal': Items compact leftward
+ * - 'wrap': Items arranged in wrapped-paragraph style (like words in text)
+ * - null: No compaction (free-form positioning)
+ */
+type CompactType = 'horizontal' | 'vertical' | 'wrap' | null;
+/**
+ * Interface for layout compaction strategies.
+ *
+ * Implement this interface to create custom compaction algorithms.
+ */
+interface Compactor {
+  /** Compaction type identifier */
+  readonly type: CompactType;
+  /**
+   * Whether items can overlap (stack on top of each other).
+   *
+   * When true items can be placed on top of other items, dragging into another
+   * item does NOT push it away, and compaction is skipped after drag/resize.
+   */
+  readonly allowOverlap: boolean;
+  /**
+   * Whether to block movement that would cause collision.
+   *
+   * When true (and allowOverlap is false) dragging into another item is blocked
+   * (item snaps back) and other items are NOT pushed away. Only affects
+   * drag/resize, not compaction. Has no effect when allowOverlap is true.
+   */
+  readonly preventCollision?: boolean;
+  /**
+   * Compact the layout.
+   *
+   * @param layout - The layout to compact
+   * @param cols - Number of columns in the grid
+   * @returns The compacted layout
+   */
+  compact(layout: Layout, cols: number): Layout;
+}
+/** Context provided to constraint functions during drag/resize operations. */
+interface ConstraintContext {
+  /** Number of columns in the grid */
+  cols: number;
+  /** Maximum number of rows (Infinity if unbounded) */
+  maxRows: number;
+  /** Container width in pixels */
+  containerWidth: number;
+  /** Container height in pixels (may be 0 if auto-height) */
+  containerHeight: number;
+  /** Row height in pixels */
+  rowHeight: number;
+  /** Margin between items [x, y] in pixels */
+  margin: readonly [number, number];
+  /** Current layout state */
+  layout: Layout;
+}
+/**
+ * Interface for layout constraints.
+ *
+ * Implement this interface to create custom position/size constraints.
+ * Built-in constraints: gridBounds, minMaxSize, containerBounds, boundedX,
+ * boundedY.
+ */
+interface LayoutConstraint {
+  /** Constraint identifier for debugging */
+  readonly name: string;
+  /**
+   * Constrain position during drag operations. Called after grid unit
+   * conversion, before layout update.
+   */
+  constrainPosition?(item: LayoutItem, x: number, y: number, context: ConstraintContext): {
+    x: number;
+    y: number;
+  };
+  /**
+   * Constrain size during resize operations. Called after grid unit conversion,
+   * before layout update.
+   */
+  constrainSize?(item: LayoutItem, w: number, h: number, handle: ResizeHandleAxis, context: ConstraintContext): {
+    w: number;
+    h: number;
+  };
+}
+//#endregion
+export { CompactType, Compactor, Layout, LayoutConstraint, LayoutItem, ResizeHandleAxis };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/layout/Board/index.d.ts

@@ -0,0 +1,21 @@
+
+import { Compactor, Layout, LayoutConstraint, LayoutItem, ResizeHandleAxis } from "./grid-core/types.js";
+import { getCompactor, horizontalCompactor, noCompactor, verticalCompactor } from "./grid-core/compactors.js";
+import { aspectRatio, boundedX, boundedY, containerBounds, gridBounds, maxSize, minMaxSize, minSize, snapToGrid } from "./grid-core/constraints.js";
+import { BoardCompactType, BoardGridLines, BoardInteractionInfo, CubeBoardProps } from "./Board.js";
+import { BreakpointCols, Breakpoints, ResponsiveLayouts } from "./responsive-utils.js";
+import { BoardResponsive, CubeBoardResponsiveProps } from "./BoardResponsive.js";
+import { WidgetTransferInfo } from "./board-context.js";
+import { BoardProvider, CubeBoardProviderProps } from "./BoardProvider.js";
+import { CubeBoardWidgetProps, Widget } from "./Widget.js";
+import * as react from "react";
+
+//#region src/components/layout/Board/index.d.ts
+declare const Board: react.ForwardRefExoticComponent<CubeBoardProps & react.RefAttributes<HTMLDivElement>> & {
+  Widget: typeof Widget;
+  Provider: typeof BoardProvider;
+  Responsive: react.ForwardRefExoticComponent<CubeBoardResponsiveProps & react.RefAttributes<HTMLDivElement>>;
+};
+//#endregion
+export { Board };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/layout/Board/index.js

@@ -0,0 +1,18 @@
+/** @license MIT | @cube-dev/ui-kit v0.144.0 | Cube Dev Team */
+import { getCompactor, horizontalCompactor, noCompactor, verticalCompactor } from "./grid-core/compactors.js";
+import { aspectRatio, boundedX, boundedY, containerBounds, gridBounds, maxSize, minMaxSize, minSize, snapToGrid } from "./grid-core/constraints.js";
+import { BoardProvider } from "./BoardProvider.js";
+import { Board as Board$1 } from "./Board.js";
+import { BoardResponsive } from "./BoardResponsive.js";
+import { Widget } from "./Widget.js";
+
+//#region src/components/layout/Board/index.tsx
+const Board = Object.assign(Board$1, {
+	Widget,
+	Provider: BoardProvider,
+	Responsive: BoardResponsive
+});
+
+//#endregion
+export { Board };
+//# sourceMappingURL=index.js.map

package/dist/components/layout/Board/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["BoardBase"],"sources":["../../../../src/components/layout/Board/index.tsx"],"sourcesContent":["import { Board as BoardBase } from './Board';\nimport { BoardProvider } from './BoardProvider';\nimport { BoardResponsive } from './BoardResponsive';\nimport { Widget } from './Widget';\n\nconst Board = Object.assign(BoardBase, {\n  Widget,\n  Provider: BoardProvider,\n  Responsive: BoardResponsive,\n});\n\nexport { Board };\nexport { BoardProvider };\nexport { BoardResponsive };\nexport { Widget as BoardWidget };\n\nexport type {\n  CubeBoardProps,\n  BoardCompactType,\n  BoardGridLines,\n  BoardInteractionInfo,\n} from './Board';\nexport type { CubeBoardResponsiveProps } from './BoardResponsive';\nexport type { CubeBoardWidgetProps } from './Widget';\nexport type { CubeBoardProviderProps } from './BoardProvider';\nexport type { WidgetTransferInfo } from './board-context';\nexport type {\n  Breakpoints as BoardBreakpoints,\n  BreakpointCols as BoardBreakpointCols,\n  ResponsiveLayouts as BoardResponsiveLayouts,\n} from './responsive-utils';\n\nexport type {\n  Layout,\n  LayoutItem,\n  ResizeHandleAxis,\n  Compactor,\n  LayoutConstraint,\n  PositionParams,\n} from './grid-core';\n\nexport {\n  verticalCompactor,\n  horizontalCompactor,\n  noCompactor,\n  getCompactor,\n  gridBounds,\n  minMaxSize,\n  containerBounds,\n  boundedX,\n  boundedY,\n  aspectRatio,\n  snapToGrid,\n  minSize,\n  maxSize,\n} from './grid-core';\n"],"mappings":";;;;;;;;;AAKA,MAAM,QAAQ,OAAO,OAAOA,SAAW;CACrC;CACA,UAAU;CACV,YAAY;CACb,CAAC"}

package/dist/components/layout/Board/responsive-utils.d.ts

@@ -0,0 +1,13 @@
+
+import { LayoutItem } from "./grid-core/types.js";
+
+//#region src/components/layout/Board/responsive-utils.d.ts
+/** Map of breakpoint name -> minimum container width (px). */
+type Breakpoints = Record<string, number>;
+/** Map of breakpoint name -> column count. */
+type BreakpointCols = Record<string, number>;
+/** Map of breakpoint name -> layout. */
+type ResponsiveLayouts = Record<string, LayoutItem[]>;
+//#endregion
+export { BreakpointCols, Breakpoints, ResponsiveLayouts };
+//# sourceMappingURL=responsive-utils.d.ts.map

package/dist/components/layout/Board/responsive-utils.js

@@ -0,0 +1,55 @@
+/** @license MIT | @cube-dev/ui-kit v0.144.0 | Cube Dev Team */
+import { cloneLayout, correctBounds } from "./grid-core/layout.js";
+
+//#region src/components/layout/Board/responsive-utils.ts
+/**
+* Responsive helpers for `Board.Responsive`.
+*
+* Framework-agnostic breakpoint math adapted (MIT) from react-grid-layout's
+* `responsiveUtils`, rewritten to use this package's grid-core primitives. See
+* ./grid-core/NOTICE.md for the upstream attribution and license.
+*/
+/** Breakpoint names sorted ascending by their minimum width. */
+function sortBreakpoints(breakpoints) {
+	return Object.keys(breakpoints).sort((a, b) => breakpoints[a] - breakpoints[b]);
+}
+/**
+* The largest breakpoint whose minimum width is at or below `width`. Falls back
+* to the smallest breakpoint when `width` is narrower than all of them.
+*/
+function getBreakpointFromWidth(breakpoints, width) {
+	const sorted = sortBreakpoints(breakpoints);
+	let matching = sorted[0];
+	for (let i = 1; i < sorted.length; i++) {
+		const name = sorted[i];
+		if (width >= breakpoints[name]) matching = name;
+	}
+	return matching;
+}
+/** Column count for a breakpoint. */
+function getColsFromBreakpoint(breakpoint, cols) {
+	const value = cols[breakpoint];
+	if (value == null) throw new Error(`Board.Responsive: no columns defined for breakpoint "${breakpoint}".`);
+	return value;
+}
+/**
+* The layout for `breakpoint`, or one synthesized from the nearest available
+* breakpoint (preferring `lastBreakpoint`, then breakpoints at or above the
+* target) corrected into bounds and compacted for the target column count.
+*/
+function findOrGenerateResponsiveLayout(layouts, breakpoints, breakpoint, lastBreakpoint, cols, compactor) {
+	if (layouts[breakpoint]) return cloneLayout(layouts[breakpoint]);
+	let layout = layouts[lastBreakpoint];
+	const sorted = sortBreakpoints(breakpoints);
+	const above = sorted.slice(sorted.indexOf(breakpoint));
+	for (const name of above) if (layouts[name]) {
+		layout = layouts[name];
+		break;
+	}
+	layout = cloneLayout(layout || []);
+	return [...compactor.compact(correctBounds(layout, { cols }), cols)];
+}
+
+//#endregion
+export { findOrGenerateResponsiveLayout, getBreakpointFromWidth, getColsFromBreakpoint };
+//# sourceMappingURL=responsive-utils.js.map

package/dist/components/layout/Board/responsive-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-utils.js","names":[],"sources":["../../../../src/components/layout/Board/responsive-utils.ts"],"sourcesContent":["/**\n * Responsive helpers for `Board.Responsive`.\n *\n * Framework-agnostic breakpoint math adapted (MIT) from react-grid-layout's\n * `responsiveUtils`, rewritten to use this package's grid-core primitives. See\n * ./grid-core/NOTICE.md for the upstream attribution and license.\n */\nimport { cloneLayout, Compactor, correctBounds, LayoutItem } from './grid-core';\n\n/** Map of breakpoint name -> minimum container width (px). */\nexport type Breakpoints = Record<string, number>;\n/** Map of breakpoint name -> column count. */\nexport type BreakpointCols = Record<string, number>;\n/** Map of breakpoint name -> layout. */\nexport type ResponsiveLayouts = Record<string, LayoutItem[]>;\n\n/** Breakpoint names sorted ascending by their minimum width. */\nexport function sortBreakpoints(breakpoints: Breakpoints): string[] {\n  return Object.keys(breakpoints).sort(\n    (a, b) => breakpoints[a] - breakpoints[b],\n  );\n}\n\n/**\n * The largest breakpoint whose minimum width is at or below `width`. Falls back\n * to the smallest breakpoint when `width` is narrower than all of them.\n */\nexport function getBreakpointFromWidth(\n  breakpoints: Breakpoints,\n  width: number,\n): string {\n  const sorted = sortBreakpoints(breakpoints);\n  let matching = sorted[0];\n  for (let i = 1; i < sorted.length; i++) {\n    const name = sorted[i];\n    if (width >= breakpoints[name]) matching = name;\n  }\n  return matching;\n}\n\n/** Column count for a breakpoint. */\nexport function getColsFromBreakpoint(\n  breakpoint: string,\n  cols: BreakpointCols,\n): number {\n  const value = cols[breakpoint];\n  if (value == null) {\n    throw new Error(\n      `Board.Responsive: no columns defined for breakpoint \"${breakpoint}\".`,\n    );\n  }\n  return value;\n}\n\n/**\n * The layout for `breakpoint`, or one synthesized from the nearest available\n * breakpoint (preferring `lastBreakpoint`, then breakpoints at or above the\n * target) corrected into bounds and compacted for the target column count.\n */\nexport function findOrGenerateResponsiveLayout(\n  layouts: ResponsiveLayouts,\n  breakpoints: Breakpoints,\n  breakpoint: string,\n  lastBreakpoint: string,\n  cols: number,\n  compactor: Compactor,\n): LayoutItem[] {\n  if (layouts[breakpoint]) return cloneLayout(layouts[breakpoint]);\n\n  let layout = layouts[lastBreakpoint];\n  const sorted = sortBreakpoints(breakpoints);\n  const above = sorted.slice(sorted.indexOf(breakpoint));\n  for (const name of above) {\n    if (layouts[name]) {\n      layout = layouts[name];\n      break;\n    }\n  }\n\n  layout = cloneLayout(layout || []);\n  return [...compactor.compact(correctBounds(layout, { cols }), cols)];\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,gBAAgB,aAAoC;AAClE,QAAO,OAAO,KAAK,YAAY,CAAC,MAC7B,GAAG,MAAM,YAAY,KAAK,YAAY,GACxC;;;;;;AAOH,SAAgB,uBACd,aACA,OACQ;CACR,MAAM,SAAS,gBAAgB,YAAY;CAC3C,IAAI,WAAW,OAAO;AACtB,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EACtC,MAAM,OAAO,OAAO;AACpB,MAAI,SAAS,YAAY,MAAO,YAAW;;AAE7C,QAAO;;;AAIT,SAAgB,sBACd,YACA,MACQ;CACR,MAAM,QAAQ,KAAK;AACnB,KAAI,SAAS,KACX,OAAM,IAAI,MACR,wDAAwD,WAAW,IACpE;AAEH,QAAO;;;;;;;AAQT,SAAgB,+BACd,SACA,aACA,YACA,gBACA,MACA,WACc;AACd,KAAI,QAAQ,YAAa,QAAO,YAAY,QAAQ,YAAY;CAEhE,IAAI,SAAS,QAAQ;CACrB,MAAM,SAAS,gBAAgB,YAAY;CAC3C,MAAM,QAAQ,OAAO,MAAM,OAAO,QAAQ,WAAW,CAAC;AACtD,MAAK,MAAM,QAAQ,MACjB,KAAI,QAAQ,OAAO;AACjB,WAAS,QAAQ;AACjB;;AAIJ,UAAS,YAAY,UAAU,EAAE,CAAC;AAClC,QAAO,CAAC,GAAG,UAAU,QAAQ,cAAc,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC"}

package/dist/components/layout/Board/use-board-layout.js

@@ -0,0 +1,52 @@
+/** @license MIT | @cube-dev/ui-kit v0.144.0 | Cube Dev Team */
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { cloneLayout } from "./grid-core/layout.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region src/components/layout/Board/use-board-layout.ts
+/**
+* Headless layout state for a single board.
+*
+* Supports both controlled (`layout`) and uncontrolled (`defaultLayout`) usage.
+* Intermediate drag/resize previews always update local state; only committed
+* changes call `onLayoutChange`.
+*/
+function useBoardLayout(options) {
+	const { layout: controlledLayout, defaultLayout, onLayoutChange } = options;
+	const isControlled = controlledLayout !== void 0;
+	const [layout, setLayout] = useState(() => cloneLayout(controlledLayout ?? defaultLayout ?? []));
+	const layoutRef = useRef(layout);
+	layoutRef.current = layout;
+	const [placeholder, setPlaceholderState] = useState(null);
+	const placeholderRef = useRef(null);
+	const setPlaceholder = useCallback((item) => {
+		placeholderRef.current = item;
+		setPlaceholderState(item);
+	}, []);
+	const onLayoutChangeEvent = useEvent((next) => onLayoutChange?.(next));
+	const prevControlledRef = useRef(controlledLayout);
+	useEffect(() => {
+		if (isControlled && controlledLayout !== prevControlledRef.current) {
+			prevControlledRef.current = controlledLayout;
+			const next = cloneLayout(controlledLayout ?? []);
+			layoutRef.current = next;
+			setLayout(next);
+		}
+	}, [controlledLayout, isControlled]);
+	return {
+		layout,
+		layoutRef,
+		placeholder,
+		placeholderRef,
+		setPlaceholder,
+		applyLayout: useCallback((next, commit) => {
+			layoutRef.current = next;
+			setLayout(next);
+			if (commit) onLayoutChangeEvent(next);
+		}, [onLayoutChangeEvent])
+	};
+}
+
+//#endregion
+export { useBoardLayout };
+//# sourceMappingURL=use-board-layout.js.map

package/dist/components/layout/Board/use-board-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-board-layout.js","names":[],"sources":["../../../../src/components/layout/Board/use-board-layout.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal/hooks';\n\nimport { cloneLayout, LayoutItem } from './grid-core';\n\nexport interface UseBoardLayoutOptions {\n  /** Controlled layout. */\n  layout?: LayoutItem[];\n  /** Initial layout for uncontrolled usage. */\n  defaultLayout?: LayoutItem[];\n  onLayoutChange?: (layout: LayoutItem[]) => void;\n}\n\nexport interface UseBoardLayoutResult {\n  layout: LayoutItem[];\n  layoutRef: React.MutableRefObject<LayoutItem[]>;\n  placeholder: LayoutItem | null;\n  /**\n   * Synchronously-updated mirror of `placeholder`. `setPlaceholder` only\n   * schedules a re-render, so consumers that run in the same tick as a\n   * `setPlaceholder` call (e.g. drag lifecycle callbacks fired right after the\n   * registry updates the placeholder) must read the ref to see the live value.\n   */\n  placeholderRef: React.MutableRefObject<LayoutItem | null>;\n  setPlaceholder: (item: LayoutItem | null) => void;\n  /** Update the layout. `commit` fires `onLayoutChange`. */\n  applyLayout: (layout: LayoutItem[], commit: boolean) => void;\n}\n\n/**\n * Headless layout state for a single board.\n *\n * Supports both controlled (`layout`) and uncontrolled (`defaultLayout`) usage.\n * Intermediate drag/resize previews always update local state; only committed\n * changes call `onLayoutChange`.\n */\nexport function useBoardLayout(\n  options: UseBoardLayoutOptions,\n): UseBoardLayoutResult {\n  const { layout: controlledLayout, defaultLayout, onLayoutChange } = options;\n  const isControlled = controlledLayout !== undefined;\n\n  const [layout, setLayout] = useState<LayoutItem[]>(() =>\n    cloneLayout(controlledLayout ?? defaultLayout ?? []),\n  );\n  const layoutRef = useRef<LayoutItem[]>(layout);\n  layoutRef.current = layout;\n\n  const [placeholder, setPlaceholderState] = useState<LayoutItem | null>(null);\n  const placeholderRef = useRef<LayoutItem | null>(null);\n  const setPlaceholder = useCallback((item: LayoutItem | null) => {\n    placeholderRef.current = item;\n    setPlaceholderState(item);\n  }, []);\n\n  const onLayoutChangeEvent = useEvent((next: LayoutItem[]) =>\n    onLayoutChange?.(next),\n  );\n\n  // Sync controlled prop into local state when it changes by reference.\n  const prevControlledRef = useRef(controlledLayout);\n  useEffect(() => {\n    if (isControlled && controlledLayout !== prevControlledRef.current) {\n      prevControlledRef.current = controlledLayout;\n      const next = cloneLayout(controlledLayout ?? []);\n      layoutRef.current = next;\n      setLayout(next);\n    }\n  }, [controlledLayout, isControlled]);\n\n  const applyLayout = useCallback(\n    (next: LayoutItem[], commit: boolean) => {\n      layoutRef.current = next;\n      setLayout(next);\n      if (commit) {\n        onLayoutChangeEvent(next);\n      }\n    },\n    [onLayoutChangeEvent],\n  );\n\n  return {\n    layout,\n    layoutRef,\n    placeholder,\n    placeholderRef,\n    setPlaceholder,\n    applyLayout,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAqCA,SAAgB,eACd,SACsB;CACtB,MAAM,EAAE,QAAQ,kBAAkB,eAAe,mBAAmB;CACpE,MAAM,eAAe,qBAAqB;CAE1C,MAAM,CAAC,QAAQ,aAAa,eAC1B,YAAY,oBAAoB,iBAAiB,EAAE,CAAC,CACrD;CACD,MAAM,YAAY,OAAqB,OAAO;AAC9C,WAAU,UAAU;CAEpB,MAAM,CAAC,aAAa,uBAAuB,SAA4B,KAAK;CAC5E,MAAM,iBAAiB,OAA0B,KAAK;CACtD,MAAM,iBAAiB,aAAa,SAA4B;AAC9D,iBAAe,UAAU;AACzB,sBAAoB,KAAK;IACxB,EAAE,CAAC;CAEN,MAAM,sBAAsB,UAAU,SACpC,iBAAiB,KAAK,CACvB;CAGD,MAAM,oBAAoB,OAAO,iBAAiB;AAClD,iBAAgB;AACd,MAAI,gBAAgB,qBAAqB,kBAAkB,SAAS;AAClE,qBAAkB,UAAU;GAC5B,MAAM,OAAO,YAAY,oBAAoB,EAAE,CAAC;AAChD,aAAU,UAAU;AACpB,aAAU,KAAK;;IAEhB,CAAC,kBAAkB,aAAa,CAAC;AAapC,QAAO;EACL;EACA;EACA;EACA;EACA;EACA,aAjBkB,aACjB,MAAoB,WAAoB;AACvC,aAAU,UAAU;AACpB,aAAU,KAAK;AACf,OAAI,OACF,qBAAoB,KAAK;KAG7B,CAAC,oBAAoB,CACtB;EASA"}