Adding Javascript support for the Extended Searchbox API.

chrome/common/instant_types.h

-// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_COMMON_INSTANT_TYPES_H_
 #define CHROME_COMMON_INSTANT_TYPES_H_
 
-// Enum describing the ways instant suggest text can be completed.
+#include <string>
+
+#include "googleurl/src/gurl.h"
+
+// Ways that the Instant suggested text is autocompleted into the omnibox.
 enum InstantCompleteBehavior {
-  // Complete the suggestion now.
+  // Autocomplete the suggestion immediately.
   INSTANT_COMPLETE_NOW,
 
-  // Complete the suggestion after a delay.
+  // Autocomplete the suggestion after a delay.
   INSTANT_COMPLETE_DELAYED,
 
-  // Never complete the suggestion.
-  INSTANT_COMPLETE_NEVER
+  // Do not autocomplete the suggestion. The suggestion may still be displayed
+  // in the omnibox, but not made a part of the omnibox text by default (e.g.,
+  // by displaying the suggestion as non-highlighted, non-selected gray text).
+  INSTANT_COMPLETE_NEVER,
+
+  // Treat the suggested text as the entire omnibox text, effectively replacing
+  // whatever the user has typed.
+  INSTANT_COMPLETE_REPLACE,
+};
+
+// The type of suggestion provided by Instant. For example, if Instant suggests
+// "yahoo.com", should that be considered a search string or a URL?
+enum InstantSuggestionType {
+  INSTANT_SUGGESTION_SEARCH,
+  INSTANT_SUGGESTION_URL,
+};
+
+// A wrapper to hold Instant suggested text and its metadata such as the type
+// of the suggestion and what completion behavior should be applied to it.
+struct InstantSuggestion {
+  InstantSuggestion();
+  InstantSuggestion(const std::string& in_text,

[sky, 2012/07/24 21:14:32]

nuke in_ from all these.

[Shishir, 2012/07/24 21:31:37]

Done.

+                    InstantCompleteBehavior in_behavior,
+                    InstantSuggestionType in_type);
+  ~InstantSuggestion();
+
+  std::string text;
+  InstantCompleteBehavior behavior;
+  InstantSuggestionType type;
+};
+
+// Omnibox dropdown matches provided by the native autocomplete providers.
+struct InstantNativeSuggestionsParts {
+  InstantNativeSuggestionsParts();
+  ~InstantNativeSuggestionsParts();
+
+  // The provider name. May be empty.
+  std::string provider;
+
+  // True iff this is a search suggestion.
+  bool is_search;
+
+  // The title of the match.
+  std::string contents;
+
+  // The URL of the match.
+  // TODO(dhollowa): Remove this once the privacy story is sorted out.
+  GURL destination_url;
+
+  // The relevance score of this match.

[sky, 2012/07/24 21:14:32]

Document what 'relevance' means here, and in particular what the range of this
is.

[Shishir, 2012/07/24 21:31:37]

Mentioned that it is the same relevance stored in AutocompleteMatch.

+  int relevance;
+};
+
+// How to interpret the size (dimensions) of the Instant overlay (preview).
+enum InstantSizeUnits {
+  // As an absolute number of pixels.
+  INSTANT_SIZE_PIXELS,
+
+  // As a percentage of the size of the containing (parent) view.

[sky, 2012/07/24 21:14:32]

size or height?

[Shishir, 2012/07/24 21:31:37]

Can be height or width. Made clear in comments.

+  INSTANT_SIZE_PERCENT,
 };
 
 #endif  // CHROME_COMMON_INSTANT_TYPES_H_