Ensure valid VisiblePosition input for absoluteCaretBoundsOf

third_party/WebKit/Source/core/editing/VisibleUnits.h

 /*
  * Copyright (C) 2004 Apple Computer, Inc.  All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 99 matching lines @@
 // If true, adjacent candidates are visually distinct.
 CORE_EXPORT bool endsOfNodeAreVisuallyDistinctPositions(const Node*);
 
 CORE_EXPORT Position canonicalPositionOf(const Position&);
 CORE_EXPORT PositionInFlatTree canonicalPositionOf(const PositionInFlatTree&);
 
 // Bounds of (possibly transformed) caret in absolute coords
 CORE_EXPORT IntRect absoluteCaretBoundsOf(const VisiblePosition&);
 CORE_EXPORT IntRect absoluteCaretBoundsOf(const VisiblePositionInFlatTree&);
 
+// This deprecated function accepts an invalid VisiblePosition as input, which
+// is discouraged. Callers should ensure passing a valid VisiblePosition to the
+// un-deprecated function listed above.
+CORE_EXPORT IntRect absoluteCaretBoundsOfDeprecated(const VisiblePosition&);
+
 CORE_EXPORT UChar32 characterAfter(const VisiblePosition&);
 CORE_EXPORT UChar32 characterAfter(const VisiblePositionInFlatTree&);
 CORE_EXPORT UChar32 characterBefore(const VisiblePosition&);
 CORE_EXPORT UChar32 characterBefore(const VisiblePositionInFlatTree&);
 
 // TODO(yosin) Since return value of |leftPositionOf()| with |VisiblePosition|
 // isn't defined well on flat tree, we should not use it for a position in
 // flat tree.
 CORE_EXPORT VisiblePosition leftPositionOf(const VisiblePosition&);
 CORE_EXPORT VisiblePositionInFlatTree leftPositionOf(const VisiblePositionInFlatTree&);
@@ skipping 128 matching lines @@
 
 // Returns a hit-tested VisiblePosition for the given point in contents-space
 // coordinates.
 CORE_EXPORT VisiblePosition visiblePositionForContentsPoint(const IntPoint&, LocalFrame*);
 
 CORE_EXPORT bool rendersInDifferentPosition(const Position&, const Position&);
 
 } // namespace blink
 
 #endif // VisibleUnits_h