@atlaskit/link-picker 1.9.4 → 1.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @atlaskit/link-picker
 
+## 1.10.0
+
+### Minor Changes
+
+- [`7dbc77d866a`](https://bitbucket.org/atlassian/atlassian-frontend/commits/7dbc77d866a) - Adds support for plugins providing metadata about resolved links.
+
 ## 1.9.4
 
 ### Patch Changes

package/dist/cjs/analytics.codegen.js

@@ -10,7 +10,7 @@ exports.default = void 0;
  *
  * Generates analytics utilities from the package analytics spec yaml
  *
- * @codegen <<SignedSource::3c46f1d8f463b6898a7a0e1e1f4676b4>>
+ * @codegen <<SignedSource::e8a730530bb93e19d0b85114da0581c8>>
  * @codegenCommand yarn workspace @atlaskit/link-picker run codegen-analytics
  */
 function createEventPayload(eventKey, attributes) {

package/dist/cjs/common/analytics/context.js

@@ -36,6 +36,7 @@ var DEFAULT_CONTEXT_ATTRIBUTES = {
   linkState: 'newLink',
   linkFieldContent: null,
   linkFieldContentInputMethod: null,
+  linkFieldContentInputSource: null,
   displayTextFieldContent: null,
   displayTextFieldContentInputMethod: null
 };

package/dist/cjs/services/use-plugins/index.js

@@ -144,6 +144,7 @@ function usePlugins(state, activeTab, plugins) {
     tabs: tabs,
     items: items,
     isLoading: isLoading,
+    activePlugin: activePlugin,
     isActivePlugin: !!activePlugin,
     error: error,
     retry: handleRetry,

package/dist/cjs/ui/link-picker/index.js

@@ -61,6 +61,8 @@ var _linkSearchError = _interopRequireWildcard(require("./link-search-error"));
 
 var _formFooter = _interopRequireWildcard(require("./form-footer"));
 
+var _utils = require("./utils");
+
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
@@ -160,6 +162,7 @@ function LinkPicker(_ref) {
       items = _usePlugins.items,
       isLoading = _usePlugins.isLoading,
       isActivePlugin = _usePlugins.isActivePlugin,
+      activePlugin = _usePlugins.activePlugin,
       tabs = _usePlugins.tabs,
       error = _usePlugins.error,
       retry = _usePlugins.retry,
@@ -190,10 +193,12 @@ function LinkPicker(_ref) {
     }
   }, [onContentResize, items, isLoading, isActivePlugin, tabs]);
   var handleChangeUrl = (0, _react.useCallback)(function (e) {
+    /** Any on change event is triggered by manual input or paste, so source is null */
+    trackAttribute('linkFieldContentInputSource', null);
     dispatch({
       url: e.currentTarget.value
     });
-  }, []);
+  }, [trackAttribute]);
   var handleChangeText = (0, _react.useCallback)(function (e) {
     dispatch({
       displayText: e.currentTarget.value
@@ -224,23 +229,30 @@ function LinkPicker(_ref) {
         break;
     }
 
-    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && items[updatedIndex]) {
+    var item = items[updatedIndex];
+
+    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && item) {
       /**
        * Manually track that the url has been updated using searchResult method
        */
-      trackAttribute('linkFieldContent', getLinkFieldContent(items[updatedIndex].url));
+      trackAttribute('linkFieldContent', getLinkFieldContent(item.url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', (0, _utils.getDataSource)(item, activePlugin));
       dispatch({
         activeIndex: updatedIndex,
         selectedIndex: updatedIndex,
-        url: items[updatedIndex].url,
+        url: item.url,
         invalidUrl: false
       });
     }
-  }, [activeIndex, items, trackAttribute]);
+  }, [activeIndex, items, trackAttribute, activePlugin]);
   var handleClear = (0, _react.useCallback)(function (field) {
     dispatch((0, _defineProperty2.default)({}, field, ''));
   }, []);
+  var handleUrlClear = (0, _react.useCallback)(function () {
+    trackAttribute('linkFieldContentInputSource', null);
+    handleClear('url');
+  }, [trackAttribute, handleClear]);
   var handleMouseEnterResultItem = (0, _react.useCallback)(function (objectId) {
     var index = items === null || items === void 0 ? void 0 : items.findIndex(function (item) {
       return item.objectId === objectId;
@@ -291,16 +303,17 @@ function LinkPicker(_ref) {
     if (selectedItem) {
       var _url = selectedItem.url,
           name = selectedItem.name;
-      dispatchEvent(new Event('submit'));
       /**
        * Manually track that the url has been updated using searchResult method
        */
 
+      dispatchEvent(new Event('submit'));
       trackAttribute('linkFieldContent', getLinkFieldContent(_url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', (0, _utils.getDataSource)(selectedItem, activePlugin));
       handleInsert(_url, name, 'typeAhead');
     }
-  }, [handleInsert, trackAttribute, items]);
+  }, [handleInsert, trackAttribute, items, activePlugin]);
   var handleSubmit = (0, _react.useCallback)(function (event) {
     event.preventDefault();
 
@@ -361,7 +374,7 @@ function LinkPicker(_ref) {
     "aria-activedescendant": ariaActiveDescendant,
     "aria-describedby": screenReaderDescriptionId,
     error: invalidUrl ? intl.formatMessage(_messages.messages.linkInvalid) : null,
-    onClear: handleClear,
+    onClear: handleUrlClear,
     onKeyDown: handleKeyDown,
     onChange: handleChangeUrl
   }), (0, _react2.jsx)(DisplayTextInputField, {

package/dist/cjs/ui/link-picker/utils.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isUndoEvent = exports.isRedoEvent = void 0;
+exports.isUndoEvent = exports.isRedoEvent = exports.getDataSource = void 0;
 
 var _browser = require("./browser");
 
@@ -23,5 +23,17 @@ var isRedoEvent = function isRedoEvent(e) {
     !_browser.browser.mac && e.ctrlKey && e.keyCode === KeyYCode || _browser.browser.mac && e.metaKey && e.shiftKey && e.keyCode === KeyZCode || e.ctrlKey && e.shiftKey && e.keyCode === KeyZCode
   );
 };
+/**
+ * Retrieve the data source for a link given the item and the plugin that resolved it
+ */
 
-exports.isRedoEvent = isRedoEvent;
+
+exports.isRedoEvent = isRedoEvent;
+
+var getDataSource = function getDataSource(item, plugin) {
+  var _ref, _item$meta$source, _item$meta, _plugin$meta;
+
+  return (_ref = (_item$meta$source = (_item$meta = item.meta) === null || _item$meta === void 0 ? void 0 : _item$meta.source) !== null && _item$meta$source !== void 0 ? _item$meta$source : plugin === null || plugin === void 0 ? void 0 : (_plugin$meta = plugin.meta) === null || _plugin$meta === void 0 ? void 0 : _plugin$meta.source) !== null && _ref !== void 0 ? _ref : 'unknown';
+};
+
+exports.getDataSource = getDataSource;

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/link-picker",
-	"version": "1.9.4",
+	"version": "1.10.0",
 	"sideEffects": false
 }

package/dist/es2019/analytics.codegen.js

@@ -3,7 +3,7 @@
  *
  * Generates analytics utilities from the package analytics spec yaml
  *
- * @codegen <<SignedSource::3c46f1d8f463b6898a7a0e1e1f4676b4>>
+ * @codegen <<SignedSource::e8a730530bb93e19d0b85114da0581c8>>
  * @codegenCommand yarn workspace @atlaskit/link-picker run codegen-analytics
  */
 function createEventPayload(eventKey, attributes) {

package/dist/es2019/common/analytics/context.js

@@ -7,6 +7,7 @@ const DEFAULT_CONTEXT_ATTRIBUTES = {
   linkState: 'newLink',
   linkFieldContent: null,
   linkFieldContentInputMethod: null,
+  linkFieldContentInputSource: null,
   displayTextFieldContent: null,
   displayTextFieldContentInputMethod: null
 };

package/dist/es2019/services/use-plugins/index.js

@@ -78,6 +78,7 @@ export function usePlugins(state, activeTab, plugins) {
     tabs,
     items,
     isLoading,
+    activePlugin,
     isActivePlugin: !!activePlugin,
     error,
     retry: handleRetry,

package/dist/es2019/ui/link-picker/index.js

@@ -24,6 +24,7 @@ import { transformTimeStamp } from './transformTimeStamp';
 import LinkSearchList, { testIds as listTestIds } from './link-search-list';
 import LinkSearchError, { testIds as searchErrorTestIds } from './link-search-error';
 import FormFooter, { testIds as formFooterTestIds } from './form-footer';
+import { getDataSource } from './utils';
 export const RECENT_SEARCH_LIST_SIZE = 5;
 export const CONTACT_SUPPORT_LINK = 'https://support.atlassian.com/contact/';
 export const testIds = {
@@ -110,6 +111,7 @@ function LinkPicker({
     items,
     isLoading,
     isActivePlugin,
+    activePlugin,
     tabs,
     error,
     retry,
@@ -139,10 +141,12 @@ function LinkPicker({
     }
   }, [onContentResize, items, isLoading, isActivePlugin, tabs]);
   const handleChangeUrl = useCallback(e => {
+    /** Any on change event is triggered by manual input or paste, so source is null */
+    trackAttribute('linkFieldContentInputSource', null);
     dispatch({
       url: e.currentTarget.value
     });
-  }, []);
+  }, [trackAttribute]);
   const handleChangeText = useCallback(e => {
     dispatch({
       displayText: e.currentTarget.value
@@ -175,25 +179,32 @@ function LinkPicker({
         break;
     }
 
-    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && items[updatedIndex]) {
+    const item = items[updatedIndex];
+
+    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && item) {
       /**
        * Manually track that the url has been updated using searchResult method
        */
-      trackAttribute('linkFieldContent', getLinkFieldContent(items[updatedIndex].url));
+      trackAttribute('linkFieldContent', getLinkFieldContent(item.url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', getDataSource(item, activePlugin));
       dispatch({
         activeIndex: updatedIndex,
         selectedIndex: updatedIndex,
-        url: items[updatedIndex].url,
+        url: item.url,
         invalidUrl: false
       });
     }
-  }, [activeIndex, items, trackAttribute]);
+  }, [activeIndex, items, trackAttribute, activePlugin]);
   const handleClear = useCallback(field => {
     dispatch({
       [field]: ''
     });
   }, []);
+  const handleUrlClear = useCallback(() => {
+    trackAttribute('linkFieldContentInputSource', null);
+    handleClear('url');
+  }, [trackAttribute, handleClear]);
   const handleMouseEnterResultItem = useCallback(objectId => {
     const index = items === null || items === void 0 ? void 0 : items.findIndex(item => item.objectId === objectId);
     dispatch({
@@ -241,16 +252,17 @@ function LinkPicker({
         url,
         name
       } = selectedItem;
-      dispatchEvent(new Event('submit'));
       /**
        * Manually track that the url has been updated using searchResult method
        */
 
+      dispatchEvent(new Event('submit'));
       trackAttribute('linkFieldContent', getLinkFieldContent(url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', getDataSource(selectedItem, activePlugin));
       handleInsert(url, name, 'typeAhead');
     }
-  }, [handleInsert, trackAttribute, items]);
+  }, [handleInsert, trackAttribute, items, activePlugin]);
   const handleSubmit = useCallback(event => {
     event.preventDefault();
 
@@ -311,7 +323,7 @@ function LinkPicker({
     "aria-activedescendant": ariaActiveDescendant,
     "aria-describedby": screenReaderDescriptionId,
     error: invalidUrl ? intl.formatMessage(messages.linkInvalid) : null,
-    onClear: handleClear,
+    onClear: handleUrlClear,
     onKeyDown: handleKeyDown,
     onChange: handleChangeUrl
   }), jsx(DisplayTextInputField, {

package/dist/es2019/ui/link-picker/utils.js

@@ -10,4 +10,13 @@ export const isRedoEvent = e => {
   return (// ctrl + y for non-mac
     !browser.mac && e.ctrlKey && e.keyCode === KeyYCode || browser.mac && e.metaKey && e.shiftKey && e.keyCode === KeyZCode || e.ctrlKey && e.shiftKey && e.keyCode === KeyZCode
   );
+};
+/**
+ * Retrieve the data source for a link given the item and the plugin that resolved it
+ */
+
+export const getDataSource = (item, plugin) => {
+  var _ref, _item$meta$source, _item$meta, _plugin$meta;
+
+  return (_ref = (_item$meta$source = (_item$meta = item.meta) === null || _item$meta === void 0 ? void 0 : _item$meta.source) !== null && _item$meta$source !== void 0 ? _item$meta$source : plugin === null || plugin === void 0 ? void 0 : (_plugin$meta = plugin.meta) === null || _plugin$meta === void 0 ? void 0 : _plugin$meta.source) !== null && _ref !== void 0 ? _ref : 'unknown';
 };

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/link-picker",
-	"version": "1.9.4",
+	"version": "1.10.0",
 	"sideEffects": false
 }

package/dist/esm/analytics.codegen.js

@@ -3,7 +3,7 @@
  *
  * Generates analytics utilities from the package analytics spec yaml
  *
- * @codegen <<SignedSource::3c46f1d8f463b6898a7a0e1e1f4676b4>>
+ * @codegen <<SignedSource::e8a730530bb93e19d0b85114da0581c8>>
  * @codegenCommand yarn workspace @atlaskit/link-picker run codegen-analytics
  */
 function createEventPayload(eventKey, attributes) {

package/dist/esm/common/analytics/context.js

@@ -14,6 +14,7 @@ var DEFAULT_CONTEXT_ATTRIBUTES = {
   linkState: 'newLink',
   linkFieldContent: null,
   linkFieldContentInputMethod: null,
+  linkFieldContentInputSource: null,
   displayTextFieldContent: null,
   displayTextFieldContentInputMethod: null
 };

package/dist/esm/services/use-plugins/index.js

@@ -128,6 +128,7 @@ export function usePlugins(state, activeTab, plugins) {
     tabs: tabs,
     items: items,
     isLoading: isLoading,
+    activePlugin: activePlugin,
     isActivePlugin: !!activePlugin,
     error: error,
     retry: handleRetry,

package/dist/esm/ui/link-picker/index.js

@@ -30,6 +30,7 @@ import { transformTimeStamp } from './transformTimeStamp';
 import LinkSearchList, { testIds as listTestIds } from './link-search-list';
 import LinkSearchError, { testIds as searchErrorTestIds } from './link-search-error';
 import FormFooter, { testIds as formFooterTestIds } from './form-footer';
+import { getDataSource } from './utils';
 export var RECENT_SEARCH_LIST_SIZE = 5;
 export var CONTACT_SUPPORT_LINK = 'https://support.atlassian.com/contact/';
 export var testIds = _objectSpread(_objectSpread(_objectSpread(_objectSpread({
@@ -116,6 +117,7 @@ function LinkPicker(_ref) {
       items = _usePlugins.items,
       isLoading = _usePlugins.isLoading,
       isActivePlugin = _usePlugins.isActivePlugin,
+      activePlugin = _usePlugins.activePlugin,
       tabs = _usePlugins.tabs,
       error = _usePlugins.error,
       retry = _usePlugins.retry,
@@ -146,10 +148,12 @@ function LinkPicker(_ref) {
     }
   }, [onContentResize, items, isLoading, isActivePlugin, tabs]);
   var handleChangeUrl = useCallback(function (e) {
+    /** Any on change event is triggered by manual input or paste, so source is null */
+    trackAttribute('linkFieldContentInputSource', null);
     dispatch({
       url: e.currentTarget.value
     });
-  }, []);
+  }, [trackAttribute]);
   var handleChangeText = useCallback(function (e) {
     dispatch({
       displayText: e.currentTarget.value
@@ -180,23 +184,30 @@ function LinkPicker(_ref) {
         break;
     }
 
-    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && items[updatedIndex]) {
+    var item = items[updatedIndex];
+
+    if ([KEY_CODE_ARROW_DOWN, KEY_CODE_ARROW_UP].includes(keyCode) && item) {
       /**
        * Manually track that the url has been updated using searchResult method
        */
-      trackAttribute('linkFieldContent', getLinkFieldContent(items[updatedIndex].url));
+      trackAttribute('linkFieldContent', getLinkFieldContent(item.url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', getDataSource(item, activePlugin));
       dispatch({
         activeIndex: updatedIndex,
         selectedIndex: updatedIndex,
-        url: items[updatedIndex].url,
+        url: item.url,
         invalidUrl: false
       });
     }
-  }, [activeIndex, items, trackAttribute]);
+  }, [activeIndex, items, trackAttribute, activePlugin]);
   var handleClear = useCallback(function (field) {
     dispatch(_defineProperty({}, field, ''));
   }, []);
+  var handleUrlClear = useCallback(function () {
+    trackAttribute('linkFieldContentInputSource', null);
+    handleClear('url');
+  }, [trackAttribute, handleClear]);
   var handleMouseEnterResultItem = useCallback(function (objectId) {
     var index = items === null || items === void 0 ? void 0 : items.findIndex(function (item) {
       return item.objectId === objectId;
@@ -247,16 +258,17 @@ function LinkPicker(_ref) {
     if (selectedItem) {
       var _url = selectedItem.url,
           name = selectedItem.name;
-      dispatchEvent(new Event('submit'));
       /**
        * Manually track that the url has been updated using searchResult method
        */
 
+      dispatchEvent(new Event('submit'));
       trackAttribute('linkFieldContent', getLinkFieldContent(_url));
       trackAttribute('linkFieldContentInputMethod', 'searchResult');
+      trackAttribute('linkFieldContentInputSource', getDataSource(selectedItem, activePlugin));
       handleInsert(_url, name, 'typeAhead');
     }
-  }, [handleInsert, trackAttribute, items]);
+  }, [handleInsert, trackAttribute, items, activePlugin]);
   var handleSubmit = useCallback(function (event) {
     event.preventDefault();
 
@@ -317,7 +329,7 @@ function LinkPicker(_ref) {
     "aria-activedescendant": ariaActiveDescendant,
     "aria-describedby": screenReaderDescriptionId,
     error: invalidUrl ? intl.formatMessage(messages.linkInvalid) : null,
-    onClear: handleClear,
+    onClear: handleUrlClear,
     onKeyDown: handleKeyDown,
     onChange: handleChangeUrl
   }), jsx(DisplayTextInputField, {

package/dist/esm/ui/link-picker/utils.js

@@ -10,4 +10,13 @@ export var isRedoEvent = function isRedoEvent(e) {
   return (// ctrl + y for non-mac
     !browser.mac && e.ctrlKey && e.keyCode === KeyYCode || browser.mac && e.metaKey && e.shiftKey && e.keyCode === KeyZCode || e.ctrlKey && e.shiftKey && e.keyCode === KeyZCode
   );
+};
+/**
+ * Retrieve the data source for a link given the item and the plugin that resolved it
+ */
+
+export var getDataSource = function getDataSource(item, plugin) {
+  var _ref, _item$meta$source, _item$meta, _plugin$meta;
+
+  return (_ref = (_item$meta$source = (_item$meta = item.meta) === null || _item$meta === void 0 ? void 0 : _item$meta.source) !== null && _item$meta$source !== void 0 ? _item$meta$source : plugin === null || plugin === void 0 ? void 0 : (_plugin$meta = plugin.meta) === null || _plugin$meta === void 0 ? void 0 : _plugin$meta.source) !== null && _ref !== void 0 ? _ref : 'unknown';
 };

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/link-picker",
-	"version": "1.9.4",
+	"version": "1.10.0",
 	"sideEffects": false
 }

package/dist/types/analytics.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Generates analytics utilities from the package analytics spec yaml
  *
- * @codegen <<SignedSource::3c46f1d8f463b6898a7a0e1e1f4676b4>>
+ * @codegen <<SignedSource::e8a730530bb93e19d0b85114da0581c8>>
  * @codegenCommand yarn workspace @atlaskit/link-picker run codegen-analytics
  */
 export declare type PackageMetaDataType = {
@@ -16,6 +16,7 @@ export declare type LinkPickerAnalyticsContextType = {
     linkState: 'editLink' | 'newLink';
     linkFieldContent: 'url' | 'text_string' | null;
     linkFieldContentInputMethod: 'manual' | 'paste' | 'searchResult' | null;
+    linkFieldContentInputSource: string | null;
     displayTextFieldContent: 'text_string' | null;
     displayTextFieldContentInputMethod: 'manual' | 'paste' | null;
 };
@@ -27,7 +28,7 @@ export declare type TextFieldUpdatedDisplayTextFieldAttributesType = {};
 export declare type LinkPickerUnhandledErrorCaughtAttributesType = {
     browserInfo: string;
     error: string;
-    componentStack: string;
+    componentStack: string | null;
 };
 declare type AnalyticsEventAttributes = {
     'ui.form.submitted.linkPicker': FormSubmittedLinkPickerAttributesType;

package/dist/types/services/use-plugins/index.d.ts

@@ -3,6 +3,7 @@ export interface LinkPickerPluginsService {
     items: LinkSearchListItemData[] | null;
     isLoading: boolean;
     isActivePlugin: boolean;
+    activePlugin?: LinkPickerPlugin;
     tabs: {
         tabTitle: string;
     }[];

package/dist/types/ui/link-picker/utils.d.ts

@@ -1,3 +1,8 @@
 import { KeyboardEvent } from 'react';
+import { LinkPickerPlugin, LinkSearchListItemData } from '../types';
 export declare const isUndoEvent: (e: KeyboardEvent<HTMLInputElement>) => boolean;
 export declare const isRedoEvent: (e: KeyboardEvent<HTMLInputElement>) => boolean;
+/**
+ * Retrieve the data source for a link given the item and the plugin that resolved it
+ */
+export declare const getDataSource: (item: LinkSearchListItemData, plugin?: LinkPickerPlugin | undefined) => string;

package/dist/types/ui/types.d.ts

@@ -22,6 +22,11 @@ export interface LinkSearchListItemData {
     lastUpdatedDate?: Date;
     /** Whether the result is pre-fetched from activity provider */
     prefetch?: boolean;
+    /** Metadata about the result */
+    meta?: {
+        /** The data source that provided the result */
+        source?: string;
+    };
 }
 export declare type ListItemTimeStamp = {
     pageAction: string;
@@ -43,5 +48,10 @@ export interface LinkPickerPlugin {
     tabTitle?: string;
     /** Render function to customise the UI that is displayed when an error occurs resolving results */
     errorFallback?: LinkPickerPluginErrorFallback;
+    /** Metadata about the plugin */
+    meta?: {
+        /** The data source that provides all results provided by the plugin */
+        source?: string;
+    };
 }
 export declare type LinkPickerPluginErrorFallback = (error: unknown, retry: () => void) => ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/link-picker",
-  "version": "1.9.4",
+  "version": "1.10.0",
   "description": "Standalone link picker",
   "author": "Atlassian Pty Ltd",
   "publishConfig": {
@@ -57,15 +57,15 @@
     "@atlaskit/activity-provider": "^2.3.2",
     "@atlaskit/docs": "*",
     "@atlaskit/link-analytics": "^1.1.0",
-    "@atlaskit/link-test-helpers": "^1.4.0",
+    "@atlaskit/link-test-helpers": "^1.5.0",
     "@atlaskit/popup": "^1.4.0",
     "@atlaskit/ssr": "*",
     "@atlaskit/toggle": "^12.5.0",
     "@atlaskit/visual-regression": "*",
     "@atlaskit/webdriver-runner": "*",
     "@atlassian/atlassian-frontend-prettier-config-1.0.0": "npm:@atlassian/atlassian-frontend-prettier-config@1.0.0",
-    "@atlassian/link-picker-atlassian-plugin": "^19.0.0",
-    "@atlassian/link-picker-plugins": "^6.0.0",
+    "@atlassian/link-picker-atlassian-plugin": "^20.0.0",
+    "@atlassian/link-picker-plugins": "^7.0.0",
     "@atlassian/recent-work-client": "^1.6.0",
     "@atlassian/search-provider": "^2.3.0",
     "@testing-library/dom": "^8.17.1",

package/report.api.md

@@ -28,6 +28,11 @@ export declare interface LinkPickerPlugin {
   tabTitle?: string;
   /** Render function to customise the UI that is displayed when an error occurs resolving results */
   errorFallback?: LinkPickerPluginErrorFallback;
+  /** Metadata about the plugin */
+  meta?: {
+    /** The data source that provides all results provided by the plugin */
+    source?: string;
+  };
 }
 
 export declare type LinkPickerPluginErrorFallback = (
@@ -83,6 +88,11 @@ export declare interface LinkSearchListItemData {
   lastUpdatedDate?: Date;
   /** Whether the result is pre-fetched from activity provider */
   prefetch?: boolean;
+  /** Metadata about the result */
+  meta?: {
+    /** The data source that provided the result */
+    source?: string;
+  };
 }
 
 declare interface Meta {