@atlaskit/link-create 6.3.5 → 6.4.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @atlaskit/link-create
 
+## 6.4.0
+
+### Minor Changes
+
+- [`db8537fc93efc`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/db8537fc93efc) -
+  Adds diagnostic fields to the `object createFailed (linkCreate)` analytics event so that failures
+  can be attributed to the specific operation that failed. `onFailure` now accepts an optional
+  second argument describing the failed operation.
+
+  Behind the `platform_link_create_event_tracking` feature gate the event additionally records:
+  - `operation` — a controlled value identifying the failed operation (for example `fetch-space`,
+    `fetch-page`, `create-page`)
+  - `status` — the HTTP status code, when the failure was an HTTP response
+  - `traceId` — the request trace ID, when available
+
+  No URLs, paths or user-generated content are recorded.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 6.3.6
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 6.3.5
 
 ### Patch Changes

package/analytics.spec.yaml

@@ -130,6 +130,25 @@ events:
         failureType:
           type: string
           description: the name of the failure
+        operation:
+          type: string
+          required: false
+          description:
+            which operation failed, as a controlled value such as `fetch-space`, `fetch-page`,
+            `create-page` or `submit-form`. Never contains user-generated content, URLs or tenant
+            identifiers. Absent when the failing operation could not be attributed
+        status:
+          type: number
+          required: false
+          description:
+            the HTTP status code, when the failure originated from a non-OK network response.
+            Absent otherwise
+        traceId:
+          type: string
+          required: false
+          description:
+            the trace id of the failed request, used to correlate with server-side logs. Absent
+            when the failure did not originate from a network response
 
   - linkCreateExperience failed:
       type: operational

package/dist/cjs/common/constants.js

@@ -16,7 +16,7 @@ var CREATE_FORM_MIN_HEIGHT_IN_PX = exports.CREATE_FORM_MIN_HEIGHT_IN_PX = '200';
 var LINK_CREATE_FORM_POST_CREATE_FIELD = exports.LINK_CREATE_FORM_POST_CREATE_FIELD = '__post_create__';
 var PACKAGE_DATA = exports.PACKAGE_DATA = {
   packageName: "@atlaskit/link-create" || '',
-  packageVersion: "6.3.4" || '',
+  packageVersion: "6.3.6" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/cjs/common/utils/analytics/analytics.codegen.js

@@ -11,7 +11,7 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
+ * @codegen <<SignedSource::ab46b9594ace5e515376a9aa203f040c>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 

package/dist/cjs/controllers/callback-context/main.js

@@ -11,6 +11,7 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _react = _interopRequireWildcard(require("react"));
 var _analyticsNext = require("@atlaskit/analytics-next");
+var _fg = require("@atlaskit/platform-feature-flags/fg");
 var _constants = require("../../common/constants");
 var _experienceTracker = require("../../common/ui/experience-tracker");
 var _analytics = _interopRequireDefault(require("../../common/utils/analytics/analytics.codegen"));
@@ -18,6 +19,12 @@ var _errors = require("../../common/utils/errors");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * The value exposed through context. This differs from the provider's own props: internal callers
+ * may additionally supply a `LinkCreateFailureContext` identifying which operation failed, which is
+ * recorded in analytics but never forwarded to the consumer's `onFailure` prop.
+ */
+
 var LinkCreateCallbackContext = /*#__PURE__*/_react.default.createContext({});
 var LinkCreateCallbackProvider = exports.LinkCreateCallbackProvider = function LinkCreateCallbackProvider(_ref) {
   var children = _ref.children,
@@ -67,13 +74,20 @@ var LinkCreateCallbackProvider = exports.LinkCreateCallbackProvider = function L
   var handleFailure = (0, _react.useMemo)(function () {
     return {
       onFailure: function () {
-        var _onFailure2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(error) {
+        var _onFailure2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(error, context) {
+          var _context$operation;
+          var _getNetworkFields, status, traceId;
           return _regenerator.default.wrap(function (_context2) {
             while (1) switch (_context2.prev = _context2.next) {
               case 0:
-                createAnalyticsEvent((0, _analytics.default)('track.object.createFailed.linkCreate', {
+                _getNetworkFields = (0, _errors.getNetworkFields)(error), status = _getNetworkFields.status, traceId = _getNetworkFields.traceId;
+                createAnalyticsEvent((0, _analytics.default)('track.object.createFailed.linkCreate', _objectSpread({
                   failureType: (0, _errors.getErrorType)(error)
-                })).fire(_constants.ANALYTICS_CHANNEL);
+                }, (0, _fg.fg)('platform_link_create_event_tracking') ? {
+                  operation: (_context$operation = context === null || context === void 0 ? void 0 : context.operation) !== null && _context$operation !== void 0 ? _context$operation : null,
+                  status: status,
+                  traceId: traceId
+                } : {}))).fire(_constants.ANALYTICS_CHANNEL);
                 experience === null || experience === void 0 || experience.failure(error);
                 _onFailure && _onFailure(error);
               case 1:
@@ -82,7 +96,7 @@ var LinkCreateCallbackProvider = exports.LinkCreateCallbackProvider = function L
             }
           }, _callee2);
         }));
-        function onFailure(_x2) {
+        function onFailure(_x2, _x3) {
           return _onFailure2.apply(this, arguments);
         }
         return onFailure;

package/dist/cjs/ui/create-form/form-footer/edit-button/index.js

@@ -15,8 +15,6 @@ var _analytics = _interopRequireDefault(require("../../../../common/utils/analyt
 var _main = require("../../../../controllers/form-context/main");
 var _formSpy = require("../../form-spy");
 var _messages = require("./messages");
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
-
 var EditButton = exports.EditButton = function EditButton() {
   var intl = (0, _reactIntl.useIntl)();
   var _useAnalyticsEvents = (0, _analyticsNext.useAnalyticsEvents)(),

package/dist/cjs/ui/create-form/form-footer/submit-button/index.js

@@ -14,10 +14,6 @@ var _constants = require("../../../../common/constants");
 var _analytics = _interopRequireDefault(require("../../../../common/utils/analytics/analytics.codegen"));
 var _formSpy = require("../../form-spy");
 var _messages = require("../messages");
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
-
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
-
 var SubmitButton = exports.SubmitButton = function SubmitButton() {
   var intl = (0, _reactIntl.useIntl)();
   var _useAnalyticsEvents = (0, _analyticsNext.useAnalyticsEvents)(),

package/dist/es2019/common/constants.js

@@ -10,7 +10,7 @@ export const CREATE_FORM_MIN_HEIGHT_IN_PX = '200';
 export const LINK_CREATE_FORM_POST_CREATE_FIELD = '__post_create__';
 export const PACKAGE_DATA = {
   packageName: "@atlaskit/link-create" || '',
-  packageVersion: "6.3.4" || '',
+  packageVersion: "6.3.6" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/es2019/common/utils/analytics/analytics.codegen.js

@@ -3,7 +3,7 @@
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
+ * @codegen <<SignedSource::ab46b9594ace5e515376a9aa203f040c>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 

package/dist/es2019/controllers/callback-context/main.js

@@ -1,9 +1,17 @@
 import React, { useContext, useMemo } from 'react';
 import { useAnalyticsEvents } from '@atlaskit/analytics-next';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { ANALYTICS_CHANNEL } from '../../common/constants';
 import { useExperience } from '../../common/ui/experience-tracker';
 import createEventPayload from '../../common/utils/analytics/analytics.codegen';
-import { getErrorType } from '../../common/utils/errors';
+import { getErrorType, getNetworkFields } from '../../common/utils/errors';
+
+/**
+ * The value exposed through context. This differs from the provider's own props: internal callers
+ * may additionally supply a `LinkCreateFailureContext` identifying which operation failed, which is
+ * recorded in analytics but never forwarded to the consumer's `onFailure` prop.
+ */
+
 const LinkCreateCallbackContext = /*#__PURE__*/React.createContext({});
 const LinkCreateCallbackProvider = ({
   children,
@@ -36,9 +44,19 @@ const LinkCreateCallbackProvider = ({
     }
   }), [createAnalyticsEvent, onCreate, experience]);
   const handleFailure = useMemo(() => ({
-    onFailure: async error => {
+    onFailure: async (error, context) => {
+      var _context$operation;
+      const {
+        status,
+        traceId
+      } = getNetworkFields(error);
       createAnalyticsEvent(createEventPayload('track.object.createFailed.linkCreate', {
-        failureType: getErrorType(error)
+        failureType: getErrorType(error),
+        ...(fg('platform_link_create_event_tracking') ? {
+          operation: (_context$operation = context === null || context === void 0 ? void 0 : context.operation) !== null && _context$operation !== void 0 ? _context$operation : null,
+          status,
+          traceId
+        } : {})
       })).fire(ANALYTICS_CHANNEL);
       experience === null || experience === void 0 ? void 0 : experience.failure(error);
       onFailure && onFailure(error);

package/dist/es2019/ui/create-form/async-select/main.js

@@ -24,7 +24,6 @@ export function AsyncSelect({
   validators,
   validationHelpText,
   testId = TEST_ID,
-  //@ts-ignore react-select unsupported props
   defaultOption: propsDefaultValue,
   loadOptions: loadOptionsFn,
   ...restProps

package/dist/es2019/ui/create-form/form-footer/edit-button/index.js

@@ -6,7 +6,6 @@ import LoadingButton from '@atlaskit/button/loading-button';
 import { ANALYTICS_CHANNEL, LINK_CREATE_FORM_POST_CREATE_FIELD } from '../../../../common/constants';
 import createEventPayload from '../../../../common/utils/analytics/analytics.codegen';
 import { useFormContext } from '../../../../controllers/form-context/main';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { FormSpy } from '../../form-spy';
 import { messages } from './messages';
 export const EditButton = () => {

package/dist/es2019/ui/create-form/form-footer/submit-button/index.js

@@ -5,9 +5,7 @@ import { useAnalyticsEvents } from '@atlaskit/analytics-next';
 import LoadingButton from '@atlaskit/button/loading-button';
 import { ANALYTICS_CHANNEL, LINK_CREATE_FORM_POST_CREATE_FIELD } from '../../../../common/constants';
 import createEventPayload from '../../../../common/utils/analytics/analytics.codegen';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { FormSpy } from '../../form-spy';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { messages } from '../messages';
 export const SubmitButton = () => {
   const intl = useIntl();

package/dist/esm/common/constants.js

@@ -10,7 +10,7 @@ export var CREATE_FORM_MIN_HEIGHT_IN_PX = '200';
 export var LINK_CREATE_FORM_POST_CREATE_FIELD = '__post_create__';
 export var PACKAGE_DATA = {
   packageName: "@atlaskit/link-create" || '',
-  packageVersion: "6.3.4" || '',
+  packageVersion: "6.3.6" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/esm/common/utils/analytics/analytics.codegen.js

@@ -4,7 +4,7 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
+ * @codegen <<SignedSource::ab46b9594ace5e515376a9aa203f040c>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 

package/dist/esm/controllers/callback-context/main.js

@@ -5,10 +5,18 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import React, { useContext, useMemo } from 'react';
 import { useAnalyticsEvents } from '@atlaskit/analytics-next';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { ANALYTICS_CHANNEL } from '../../common/constants';
 import { useExperience } from '../../common/ui/experience-tracker';
 import createEventPayload from '../../common/utils/analytics/analytics.codegen';
-import { getErrorType } from '../../common/utils/errors';
+import { getErrorType, getNetworkFields } from '../../common/utils/errors';
+
+/**
+ * The value exposed through context. This differs from the provider's own props: internal callers
+ * may additionally supply a `LinkCreateFailureContext` identifying which operation failed, which is
+ * recorded in analytics but never forwarded to the consumer's `onFailure` prop.
+ */
+
 var LinkCreateCallbackContext = /*#__PURE__*/React.createContext({});
 var LinkCreateCallbackProvider = function LinkCreateCallbackProvider(_ref) {
   var children = _ref.children,
@@ -58,13 +66,20 @@ var LinkCreateCallbackProvider = function LinkCreateCallbackProvider(_ref) {
   var handleFailure = useMemo(function () {
     return {
       onFailure: function () {
-        var _onFailure2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(error) {
+        var _onFailure2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(error, context) {
+          var _context$operation;
+          var _getNetworkFields, status, traceId;
           return _regeneratorRuntime.wrap(function (_context2) {
             while (1) switch (_context2.prev = _context2.next) {
               case 0:
-                createAnalyticsEvent(createEventPayload('track.object.createFailed.linkCreate', {
+                _getNetworkFields = getNetworkFields(error), status = _getNetworkFields.status, traceId = _getNetworkFields.traceId;
+                createAnalyticsEvent(createEventPayload('track.object.createFailed.linkCreate', _objectSpread({
                   failureType: getErrorType(error)
-                })).fire(ANALYTICS_CHANNEL);
+                }, fg('platform_link_create_event_tracking') ? {
+                  operation: (_context$operation = context === null || context === void 0 ? void 0 : context.operation) !== null && _context$operation !== void 0 ? _context$operation : null,
+                  status: status,
+                  traceId: traceId
+                } : {}))).fire(ANALYTICS_CHANNEL);
                 experience === null || experience === void 0 || experience.failure(error);
                 _onFailure && _onFailure(error);
               case 1:
@@ -73,7 +88,7 @@ var LinkCreateCallbackProvider = function LinkCreateCallbackProvider(_ref) {
             }
           }, _callee2);
         }));
-        function onFailure(_x2) {
+        function onFailure(_x2, _x3) {
           return _onFailure2.apply(this, arguments);
         }
         return onFailure;

package/dist/esm/ui/create-form/form-footer/edit-button/index.js

@@ -6,7 +6,6 @@ import LoadingButton from '@atlaskit/button/loading-button';
 import { ANALYTICS_CHANNEL, LINK_CREATE_FORM_POST_CREATE_FIELD } from '../../../../common/constants';
 import createEventPayload from '../../../../common/utils/analytics/analytics.codegen';
 import { useFormContext } from '../../../../controllers/form-context/main';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { FormSpy } from '../../form-spy';
 import { messages } from './messages';
 export var EditButton = function EditButton() {

package/dist/esm/ui/create-form/form-footer/submit-button/index.js

@@ -5,9 +5,7 @@ import { useAnalyticsEvents } from '@atlaskit/analytics-next';
 import LoadingButton from '@atlaskit/button/loading-button';
 import { ANALYTICS_CHANNEL, LINK_CREATE_FORM_POST_CREATE_FIELD } from '../../../../common/constants';
 import createEventPayload from '../../../../common/utils/analytics/analytics.codegen';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { FormSpy } from '../../form-spy';
-// eslint-disable-next-line @atlassian/tangerine/import/no-parent-imports
 import { messages } from '../messages';
 export var SubmitButton = function SubmitButton() {
   var intl = useIntl();

package/dist/types/common/types.d.ts

@@ -1,5 +1,17 @@
 import { type ReactNode } from 'react';
 import { type ModalDialogProps } from '@atlaskit/modal-dialog';
+/**
+ * Identifies which Link Create operation failed.
+ *
+ * This is a controlled vocabulary used for analytics only. It must never contain
+ * user-generated content, URLs, or tenant identifiers.
+ */
+export type LinkCreateOperation = 'fetch-space' | 'fetch-page' | 'load-default-values' | 'create-page' | 'create-whiteboard';
+/** Additional, non-identifying context describing a Link Create failure. */
+export type LinkCreateFailureContext = {
+    /** Which operation was being performed when the failure occurred. */
+    operation: LinkCreateOperation;
+};
 /** Map of field names to a list of validators for that field */
 export type ValidatorMap = Record<string, Validator[]>;
 export type Validator = {

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

@@ -3,7 +3,7 @@
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
+ * @codegen <<SignedSource::ab46b9594ace5e515376a9aa203f040c>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 export type PackageMetaDataType = {
@@ -37,6 +37,9 @@ export type ObjectCreatedLinkCreateAttributesType = {
 };
 export type ObjectCreateFailedLinkCreateAttributesType = {
     failureType: string;
+    operation?: string | null;
+    status?: number | null;
+    traceId?: string | null;
 };
 export type LinkCreateExperienceFailedAttributesType = {
     errorType?: string | null;

package/dist/types/controllers/callback-context/main.d.ts

@@ -1,5 +1,5 @@
 import React, { type PropsWithChildren } from 'react';
-import { type CreatePayload } from '../../common/types';
+import { type CreatePayload, type LinkCreateFailureContext } from '../../common/types';
 interface LinkCreateCallbackProviderProps {
     /**
      * This callback for when the resource has been successfully created.
@@ -14,6 +14,14 @@ interface LinkCreateCallbackProviderProps {
      */
     onCancel?: () => void;
 }
+/**
+ * The value exposed through context. This differs from the provider's own props: internal callers
+ * may additionally supply a `LinkCreateFailureContext` identifying which operation failed, which is
+ * recorded in analytics but never forwarded to the consumer's `onFailure` prop.
+ */
+type LinkCreateCallbackContextValue = Omit<LinkCreateCallbackProviderProps, 'onFailure'> & {
+    onFailure?: (error: unknown, context?: LinkCreateFailureContext) => void;
+};
 declare const LinkCreateCallbackProvider: ({ children, onCreate, onFailure, onCancel, }: PropsWithChildren<LinkCreateCallbackProviderProps>) => React.JSX.Element;
-declare const useLinkCreateCallback: () => LinkCreateCallbackProviderProps;
+declare const useLinkCreateCallback: () => LinkCreateCallbackContextValue;
 export { LinkCreateCallbackProvider, useLinkCreateCallback };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/link-create",
-	"version": "6.3.5",
+	"version": "6.4.0",
 	"description": "The driver component of meta creation flow",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -34,15 +34,15 @@
 		"@atlaskit/afm-i18n-platform-linking-platform-link-create": "2.201.0",
 		"@atlaskit/analytics-next": "^12.3.0",
 		"@atlaskit/atlassian-context": "^1.1.0",
-		"@atlaskit/button": "^25.0.0",
+		"@atlaskit/button": "^25.1.0",
 		"@atlaskit/css": "^1.0.0",
 		"@atlaskit/empty-state": "^12.0.0",
-		"@atlaskit/form": "^16.1.0",
-		"@atlaskit/icon": "^37.3.0",
+		"@atlaskit/form": "^17.0.0",
+		"@atlaskit/icon": "^37.4.0",
 		"@atlaskit/icon-file-type": "^8.1.0",
 		"@atlaskit/intl-messages-provider": "^4.2.0",
 		"@atlaskit/link": "^5.0.0",
-		"@atlaskit/linking-common": "^11.0.0",
+		"@atlaskit/linking-common": "^11.2.0",
 		"@atlaskit/modal-dialog": "^16.3.0",
 		"@atlaskit/object": "^2.2.0",
 		"@atlaskit/platform-feature-flags": "^2.1.0",
@@ -53,9 +53,9 @@
 		"@atlaskit/spinner": "^20.1.0",
 		"@atlaskit/textfield": "^10.0.0",
 		"@atlaskit/theme": "^28.0.0",
-		"@atlaskit/tokens": "^16.4.0",
+		"@atlaskit/tokens": "^16.7.0",
 		"@babel/runtime": "^7.0.0",
-		"@compiled/react": "^1.0.0",
+		"@compiled/react": "^1.0.2",
 		"debounce-promise": "^3.1.2",
 		"final-form": "^4.20.3",
 		"react-final-form": "^6.5.3"
@@ -71,7 +71,7 @@
 		"@atlaskit/drawer": "^14.0.0",
 		"@atlaskit/link-test-helpers": "^11.0.0",
 		"@atlaskit/popup": "^6.0.0",
-		"@atlassian/a11y-jest-testing": "^0.15.0",
+		"@atlassian/a11y-jest-testing": "^0.16.0",
 		"@atlassian/feature-flags-test-utils": "^1.2.0",
 		"@atlassian/structured-docs-types": "workspace:^",
 		"@testing-library/react": "^16.3.0",
@@ -122,6 +122,10 @@
 			]
 		}
 	},
-	"platform-feature-flags": {},
+	"platform-feature-flags": {
+		"platform_link_create_event_tracking": {
+			"type": "boolean"
+		}
+	},
 	"compassUnitTestMetricSourceId": "ari:cloud:compass:a436116f-02ce-4520-8fbb-7301462a1674:metric-source/c5751cc6-3513-4070-9deb-af31e86aed34/5ebc0bfb-9b6d-4ec0-adbe-e4d5e88ace44"
 }

package/link-create.docs.tsx

@@ -1,351 +0,0 @@
-/**
- * Testing structured MCP docs for review — ignore this file.
- * Contact #dst-structured-content in Slack with questions.
- */
-
-import path from 'path';
-
-import type { StructuredContentSource } from '@atlassian/structured-docs-types/types';
-
-import packageJson from './package.json';
-
-const packagePath = path.resolve(__dirname);
-
-const documentation: StructuredContentSource = {
-	components: [
-		{
-			name: 'LinkCreate',
-			description:
-				'The driver component of the link creation (meta create) flow. Renders a modal with plugin tabs (e.g. Jira issue, Confluence page); each plugin provides a form that returns a URL and metadata on success. Use for "create and link" experiences.',
-			status: 'general-availability',
-			import: {
-				name: 'LinkCreate',
-				package: '@atlaskit/link-create',
-				type: 'default',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when the user should create a new resource (issue, page, etc.) and insert its link in one flow. Supply plugins (e.g. from link-create-jira, link-create-confluence); control visibility with active/onCancel.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the modal has an accessible title and focus is trapped; ensure plugin forms have proper labels and error messages announced.',
-			],
-			keywords: ['link-create', 'create', 'modal', 'meta create', 'plugins'],
-			categories: ['linking', 'forms', 'interaction'],
-			examples: [],
-		},
-		{
-			name: 'InlineCreate',
-			description:
-				'Inline (non-modal) link creation experience. Renders plugin forms inline so users can create a resource and get a link without opening a modal.',
-			status: 'general-availability',
-			import: {
-				name: 'InlineCreate',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when you want "create and link" inline (e.g. in a dropdown or panel) instead of a modal. Supply the same plugin structure as LinkCreate.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the inline form has an accessible name and that focus moves logically through fields.',
-			],
-			keywords: ['link-create', 'inline', 'create', 'plugins'],
-			categories: ['linking', 'forms', 'interaction'],
-			examples: [],
-		},
-		{
-			name: 'CreateForm',
-			description:
-				'Form container for a single link-create plugin. Renders the plugin form UI and handles submit, validation, and success callback. Used inside plugin form implementations.',
-			status: 'general-availability',
-			import: {
-				name: 'CreateForm',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when building a custom LinkCreatePlugin form; wrap your fields in CreateForm and use onSubmit to return CreatePayload on success.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [],
-			keywords: ['link-create', 'form', 'CreateForm', 'plugin'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'CreateFormLoader',
-			description:
-				'Loader wrapper for CreateForm that shows a loading state until form data or context is ready.',
-			status: 'general-availability',
-			import: {
-				name: 'CreateFormLoader',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when the create form depends on async data (e.g. site list, field config); show loading until ready then render CreateForm.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure loading state is announced (e.g. aria-busy or live region).',
-			],
-			keywords: ['link-create', 'form', 'loader', 'CreateFormLoader'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'FormSpy',
-			description:
-				'Component that subscribes to form state (values, errors, submitting) from react-final-form. Used to build custom UI that reacts to form state.',
-			status: 'general-availability',
-			import: {
-				name: 'FormSpy',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when you need to read or react to create form state (e.g. to enable/disable a submit button or show a summary) without controlling the form.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [],
-			keywords: ['link-create', 'form', 'FormSpy', 'react-final-form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'AsyncSelect',
-			description:
-				'Async-capable select component used in link-create forms for fields that load options from an API (e.g. project, type).',
-			status: 'general-availability',
-			import: {
-				name: 'AsyncSelect',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a create form when the dropdown options are loaded asynchronously (e.g. Jira projects, issue types).',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the select has a label and that options are announced to screen readers.',
-			],
-			keywords: ['link-create', 'select', 'async', 'form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'Select',
-			description: 'Select component for link-create forms. Use for static or sync option lists.',
-			status: 'general-availability',
-			import: {
-				name: 'Select',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a create form for dropdowns with static or synchronously available options.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: ['Ensure the select has an accessible label.'],
-			keywords: ['link-create', 'select', 'form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'SiteSelect',
-			description:
-				'Site/product picker used in link-create forms when the user must choose a site or product (e.g. Jira site, Confluence space) before other fields.',
-			status: 'general-availability',
-			import: {
-				name: 'SiteSelect',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when the create flow requires picking a site or product first; follow with form fields that depend on that selection.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the site picker has an accessible name and that selected site is announced.',
-			],
-			keywords: ['link-create', 'site', 'select', 'picker', 'form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'TextField',
-			description:
-				'Text input component for link-create forms. Wired for validation and final-form.',
-			status: 'general-availability',
-			import: {
-				name: 'TextField',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a create form for single-line text fields (e.g. title, summary).',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure each field has a visible or aria-label and that validation errors are announced.',
-			],
-			keywords: ['link-create', 'textfield', 'input', 'form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'UserPicker',
-			description:
-				'User picker component for link-create forms. Used for assignee, reporter, or other user fields.',
-			status: 'general-availability',
-			import: {
-				name: 'UserPicker',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a create form when the user must select a person (e.g. assignee, creator).',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the picker has an accessible name and that the selected user is announced.',
-			],
-			keywords: ['link-create', 'user', 'picker', 'form'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'LinkCreateCallbackProvider',
-			description:
-				'Context provider that supplies a callback (e.g. on success) to link-create. Used so plugins or parents can react to create completion.',
-			status: 'general-availability',
-			import: {
-				name: 'LinkCreateCallbackProvider',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Wrap LinkCreate or InlineCreate when you need to run custom logic (e.g. insert link, close picker) when create succeeds; consume with useLinkCreateCallback.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [],
-			keywords: ['link-create', 'callback', 'context', 'provider'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'LinkCreateExitWarningProvider',
-			description:
-				'Provider that enables an exit-confirmation when the user tries to leave the create flow with unsaved changes. Uses ExitWarningModalProvider internally.',
-			status: 'general-availability',
-			import: {
-				name: 'LinkCreateExitWarningProvider',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Wrap the create flow when you want to warn users before closing or navigating away with unsaved form data.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the exit warning modal is focusable and has an accessible title and actions.',
-			],
-			keywords: ['link-create', 'exit', 'warning', 'provider', 'unsaved'],
-			categories: ['linking', 'forms', 'interaction'],
-			examples: [],
-		},
-		{
-			name: 'CreateField',
-			description:
-				'Controller component that connects a form field to the create form state (name, validation, value). Use to build custom fields that participate in CreateForm.',
-			status: 'general-availability',
-			import: {
-				name: 'CreateField',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use when building a custom form field (e.g. custom select, date picker) that must be part of the create form validation and submit payload.',
-			],
-			contentGuidelines: [],
-			accessibilityGuidelines: [
-				'Ensure the rendered control has an accessible name and that validation errors are associated (e.g. aria-describedby).',
-			],
-			keywords: ['link-create', 'form', 'field', 'CreateField'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-	],
-	hooks: [
-		{
-			name: 'useLinkCreateCallback',
-			description:
-				'Hook that returns the link-create callback from LinkCreateCallbackProvider. Use to trigger or react to create success from child components.',
-			status: 'general-availability',
-			import: {
-				name: 'useLinkCreateCallback',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a plugin or child of LinkCreateCallbackProvider when you need access to the create-success callback.',
-			],
-			accessibilityGuidelines: [],
-			keywords: ['link-create', 'hooks', 'callback', 'useLinkCreateCallback'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-		{
-			name: 'useWithExitWarning',
-			description:
-				'Hook that wires the current form or flow into the exit-warning behavior. Use when building custom create UI that should trigger the exit warning.',
-			status: 'general-availability',
-			import: {
-				name: 'useWithExitWarning',
-				package: '@atlaskit/link-create',
-				type: 'named',
-				packagePath,
-				packageJson,
-			},
-			usageGuidelines: [
-				'Use inside a component wrapped by LinkCreateExitWarningProvider when you need to register dirty state or trigger the exit warning modal.',
-			],
-			accessibilityGuidelines: [],
-			keywords: ['link-create', 'hooks', 'exit', 'warning', 'useWithExitWarning'],
-			categories: ['linking', 'forms'],
-			examples: [],
-		},
-	],
-};
-
-export default documentation;