39dba5c7b68905d0b0bd03b87c59cf77c60a1c27
[WebKit-https.git] / Source / WebCore / PAL / pal / spi / cocoa / RevealSPI.h
1 /*
2  * Copyright (C) 2018 Apple Inc.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #import <objc/runtime.h>
27 #if PLATFORM(MAC)
28 #import <pal/spi/mac/NSImmediateActionGestureRecognizerSPI.h>
29 #endif // PLATFORM(MAC)
30 #import <wtf/SoftLinking.h>
31
32 SOFT_LINK_PRIVATE_FRAMEWORK(Reveal)
33 SOFT_LINK_PRIVATE_FRAMEWORK(RevealCore)
34 SOFT_LINK_CLASS_OPTIONAL(Reveal, RVPresenter)
35 SOFT_LINK_CLASS_OPTIONAL(Reveal, RVPresentingContext)
36 SOFT_LINK_CLASS_OPTIONAL(RevealCore, RVItem)
37 SOFT_LINK_CLASS_OPTIONAL(RevealCore, RVSelection)
38
39 #if ENABLE(REVEAL)
40
41 #if USE(APPLE_INTERNAL_SDK)
42
43 #if PLATFORM(MAC)
44 #import <Reveal/RVPresenter.h>
45 #import <Reveal/Reveal.h>
46 #endif // PLATFORM(MAC)
47 #import <RevealCore/RVItem_Private.h>
48 #import <RevealCore/RVSelection.h>
49 #import <RevealCore/RevealCore.h>
50 #else // USE(APPLE_INTERNAL_SDK)
51
52
53 @protocol RVPresenterHighlightDelegate;
54
55 @interface RVItem : NSObject <NSSecureCoding>
56 - (instancetype)initWithText:(NSString *)text selectedRange:(NSRange)selectedRange NS_DESIGNATED_INITIALIZER;
57 @end
58
59 @interface RVSelection : NSObject
60 + (NSRange)revealRangeAtIndex:(NSUInteger)clickIndex selectedRanges:(NSArray <NSValue *> *)selectedRanges shouldUpdateSelection:(BOOL *)shouldUpdateSelection;
61 @end
62
63 #if PLATFORM(MAC)
64 @interface RVPresentingContext : NSObject
65 - (instancetype)initWithPointerLocationInView:(NSPoint)pointerLocationInView inView:(NSView *)view highlightDelegate:(id<RVPresenterHighlightDelegate>)highlightDelegate;
66 @end
67 #endif
68
69 @protocol RVPresenterHighlightDelegate <NSObject>
70 @required
71 - (NSArray <NSValue *> *)revealContext:(RVPresentingContext *)context rectsForItem:(RVItem *)item;
72 @optional
73 - (void)revealContext:(RVPresentingContext *)context stopHighlightingItem:(RVItem *)item;
74 - (void)revealContext:(RVPresentingContext *)context drawRectsForItem:(RVItem *)item;
75 @end
76
77 @interface RVDocumentContext : NSObject < NSSecureCoding >
78 @end
79
80 @interface RVPresenter : NSObject
81 #if PLATFORM(MAC)
82 - (id<NSImmediateActionAnimationController>)animationControllerForItem:(RVItem *)item documentContext:(RVDocumentContext *)documentContext presentingContext:(RVPresentingContext *)presentingContext options:(NSDictionary *)options;
83 #endif // PLATFORM(MAC)
84 - (BOOL)revealItem:(RVItem *)item documentContext:(RVDocumentContext *)documentContext presentingContext:(RVPresentingContext *)presentingContext options:(NSDictionary *)options;
85 @end
86
87 #endif // !USE(APPLE_INTERNAL_SDK)
88
89 #endif // ENABLE(REVEAL)