Function snapToGrid

src/core/constraints.ts:260–285

(
  stepX: number,
  stepY: number = stepX
)

 * ```
 */
export function snapToGrid(
  stepX: number,
  stepY: number = stepX
): LayoutConstraint {
  // Validate step values to prevent division by zero or invalid snapping
  if (stepX <= 0 || stepY <= 0) {
    throw new Error(
      `snapToGrid: step values must be positive (got stepX=${stepX}, stepY=${stepY})`
    );
  }

  return {
    name: `snapToGrid(${stepX}, ${stepY})`,

    constrainPosition(
      _item: LayoutItem,
      x: number,
      y: number
    ): { x: number; y: number } {
      return {
        x: Math.round(x / stepX) * stepX,
        y: Math.round(y / stepY) * stepY
      };
    }
  };
}

/**
 * Create a minimum size constraint.