@atlaskit/link-create 5.0.1 → 5.1.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/link-create
 
+## 5.1.1
+
+### Patch Changes
+
+- Updated dependencies
+
+## 5.1.0
+
+### Minor Changes
+
+- [`c4f985702c3d5`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/c4f985702c3d5) -
+  Remove flag to increase accessibility in links.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 5.0.1
 
 ### Patch Changes

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: "5.0.0" || '',
+  packageVersion: "0.0.0-development" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/cjs/common/ui/icon/index.js

@@ -11,7 +11,7 @@ var _runtime = require("@compiled/react/runtime");
 var _react = _interopRequireDefault(require("react"));
 var _reactIntl = require("react-intl");
 var _8 = _interopRequireDefault(require("@atlaskit/icon-file-type/glyph/document/16"));
-var _9 = _interopRequireDefault(require("@atlaskit/icon-object/glyph/page-live-doc/16"));
+var _pageLiveDoc = _interopRequireDefault(require("@atlaskit/object/page-live-doc"));
 var _messages = require("./messages");
 var baseStyles = null;
 var UrlIcon = exports.UrlIcon = function UrlIcon(_ref) {
@@ -32,7 +32,7 @@ var PageIcon = exports.PageIcon = function PageIcon() {
 };
 var LiveDocIcon = exports.LiveDocIcon = function LiveDocIcon() {
   var intl = (0, _reactIntl.useIntl)();
-  return /*#__PURE__*/_react.default.createElement(_9.default, {
+  return /*#__PURE__*/_react.default.createElement(_pageLiveDoc.default, {
     label: intl.formatMessage(_messages.iconLabelMessages.pageIconLabel)
   });
 };

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

@@ -11,17 +11,17 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::7beb355391f6269c701cf87b0c222d69>>
+ * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 
 function createEventPayload(eventKey, attributes) {
-  var _eventKey$split = eventKey.split('.'),
-    _eventKey$split2 = (0, _slicedToArray2.default)(_eventKey$split, 4),
-    eventType = _eventKey$split2[0],
-    actionSubject = _eventKey$split2[1],
-    action = _eventKey$split2[2],
-    actionSubjectId = _eventKey$split2[3];
+  var _ref = eventKey.split('.'),
+    _ref2 = (0, _slicedToArray2.default)(_ref, 4),
+    eventType = _ref2[0],
+    actionSubject = _ref2[1],
+    action = _ref2[2],
+    actionSubjectId = _ref2[3];
   if (eventType === 'screen') {
     return {
       eventType: eventType,

package/dist/cjs/ui/modal-create/messages.js

@@ -9,6 +9,6 @@ var messages = exports.messages = (0, _reactIntl.defineMessages)({
   heading: {
     id: 'linkCreate.modal.heading',
     defaultMessage: 'Create new',
-    description: 'Header for the create modal'
+    description: 'Heading displayed at the top of the modal dialog used to create a new item (e.g. a page or issue)'
   }
 });

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: "5.0.0" || '',
+  packageVersion: "0.0.0-development" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/es2019/common/ui/icon/index.js

@@ -4,7 +4,7 @@ import { ax, ix } from "@compiled/react/runtime";
 import React from 'react';
 import { useIntl } from 'react-intl';
 import Document16Icon from '@atlaskit/icon-file-type/glyph/document/16';
-import PageLiveDoc16Icon from '@atlaskit/icon-object/glyph/page-live-doc/16';
+import PageLiveDocObject from '@atlaskit/object/page-live-doc';
 import { iconLabelMessages } from './messages';
 const baseStyles = null;
 export const UrlIcon = ({
@@ -26,7 +26,7 @@ export const PageIcon = () => {
 };
 export const LiveDocIcon = () => {
   const intl = useIntl();
-  return /*#__PURE__*/React.createElement(PageLiveDoc16Icon, {
+  return /*#__PURE__*/React.createElement(PageLiveDocObject, {
     label: intl.formatMessage(iconLabelMessages.pageIconLabel)
   });
 };

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::7beb355391f6269c701cf87b0c222d69>>
+ * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 
@@ -11,17 +11,17 @@ function createEventPayload(eventKey, attributes) {
   const [eventType, actionSubject, action, actionSubjectId] = eventKey.split('.');
   if (eventType === 'screen') {
     return {
-      eventType,
+      eventType: eventType,
       name: actionSubject,
       action: 'viewed',
       attributes: attributes
     };
   }
   return {
-    eventType,
-    actionSubject,
-    actionSubjectId,
-    action,
+    eventType: eventType,
+    actionSubject: actionSubject,
+    actionSubjectId: actionSubjectId,
+    action: action,
     attributes: attributes
   };
 }

package/dist/es2019/ui/modal-create/messages.js

@@ -3,6 +3,6 @@ export const messages = defineMessages({
   heading: {
     id: 'linkCreate.modal.heading',
     defaultMessage: 'Create new',
-    description: 'Header for the create modal'
+    description: 'Heading displayed at the top of the modal dialog used to create a new item (e.g. a page or issue)'
   }
 });

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: "5.0.0" || '',
+  packageVersion: "0.0.0-development" || '',
   component: COMPONENT_NAME,
   componentName: COMPONENT_NAME
 };

package/dist/esm/common/ui/icon/index.js

@@ -4,7 +4,7 @@ import { ax, ix } from "@compiled/react/runtime";
 import React from 'react';
 import { useIntl } from 'react-intl';
 import Document16Icon from '@atlaskit/icon-file-type/glyph/document/16';
-import PageLiveDoc16Icon from '@atlaskit/icon-object/glyph/page-live-doc/16';
+import PageLiveDocObject from '@atlaskit/object/page-live-doc';
 import { iconLabelMessages } from './messages';
 var baseStyles = null;
 export var UrlIcon = function UrlIcon(_ref) {
@@ -25,7 +25,7 @@ export var PageIcon = function PageIcon() {
 };
 export var LiveDocIcon = function LiveDocIcon() {
   var intl = useIntl();
-  return /*#__PURE__*/React.createElement(PageLiveDoc16Icon, {
+  return /*#__PURE__*/React.createElement(PageLiveDocObject, {
     label: intl.formatMessage(iconLabelMessages.pageIconLabel)
   });
 };

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

@@ -4,17 +4,17 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::7beb355391f6269c701cf87b0c222d69>>
+ * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 
 function createEventPayload(eventKey, attributes) {
-  var _eventKey$split = eventKey.split('.'),
-    _eventKey$split2 = _slicedToArray(_eventKey$split, 4),
-    eventType = _eventKey$split2[0],
-    actionSubject = _eventKey$split2[1],
-    action = _eventKey$split2[2],
-    actionSubjectId = _eventKey$split2[3];
+  var _ref = eventKey.split('.'),
+    _ref2 = _slicedToArray(_ref, 4),
+    eventType = _ref2[0],
+    actionSubject = _ref2[1],
+    action = _ref2[2],
+    actionSubjectId = _ref2[3];
   if (eventType === 'screen') {
     return {
       eventType: eventType,

package/dist/esm/ui/modal-create/messages.js

@@ -3,6 +3,6 @@ export var messages = defineMessages({
   heading: {
     id: 'linkCreate.modal.heading',
     defaultMessage: 'Create new',
-    description: 'Header for the create modal'
+    description: 'Heading displayed at the top of the modal dialog used to create a new item (e.g. a page or issue)'
   }
 });

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::7beb355391f6269c701cf87b0c222d69>>
+ * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 export type PackageMetaDataType = {
@@ -29,7 +29,7 @@ export type ModalDialogOpenedLinkCreateAttributesType = {};
 export type LinkCreateUnhandledErrorCaughtAttributesType = {
     browserInfo: string;
     error: string;
-    componentStack: string | null;
+    componentStack?: string | null;
 };
 export type ObjectCreatedLinkCreateAttributesType = {
     objectId: string;
@@ -39,13 +39,13 @@ export type ObjectCreateFailedLinkCreateAttributesType = {
     failureType: string;
 };
 export type LinkCreateExperienceFailedAttributesType = {
-    errorType: string | null;
-    errorMessage: string | null;
+    errorType?: string | null;
+    errorMessage?: string | null;
     experienceStatus: 'SUCCEEDED' | 'FAILED';
     previousExperienceStatus: 'STARTED' | 'SUCCEEDED' | 'FAILED';
-    path: string | null;
-    status: number | null;
-    traceId: string | null;
+    path?: string | null;
+    status?: number | null;
+    traceId?: string | null;
     isSLOFailure: boolean;
 };
 export type AnalyticsEventAttributes = {
@@ -63,19 +63,13 @@ export type AnalyticsEventAttributes = {
     'track.object.createFailed.linkCreate': ObjectCreateFailedLinkCreateAttributesType;
     'operational.linkCreateExperience.failed': LinkCreateExperienceFailedAttributesType;
 };
-declare function createEventPayload<K extends keyof AnalyticsEventAttributes>(eventKey: K, attributes: AnalyticsEventAttributes[K]): {
+type CreateEventPayloadResult<K extends keyof AnalyticsEventAttributes> = {
     eventType: string;
-    name: string | undefined;
     action: string;
     attributes: AnalyticsEventAttributes[K];
-    actionSubject?: undefined;
-    actionSubjectId?: undefined;
-} | {
-    eventType: string | undefined;
-    actionSubject: string | undefined;
-    actionSubjectId: string | undefined;
-    action: string | undefined;
-    attributes: AnalyticsEventAttributes[K];
-    name?: undefined;
+    name?: string;
+    actionSubject?: string;
+    actionSubjectId?: string;
 };
+declare function createEventPayload<K extends keyof AnalyticsEventAttributes>(eventKey: K, attributes: AnalyticsEventAttributes[K]): CreateEventPayloadResult<K>;
 export default createEventPayload;

package/dist/types-ts4.5/common/utils/analytics/analytics.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Generates Typescript types for analytics events from analytics.spec.yaml
  *
- * @codegen <<SignedSource::7beb355391f6269c701cf87b0c222d69>>
+ * @codegen <<SignedSource::af3c25c127bdcca927adcfc972a0d6cb>>
  * @codegenCommand yarn workspace @atlaskit/link-create run codegen-analytics
  */
 export type PackageMetaDataType = {
@@ -29,7 +29,7 @@ export type ModalDialogOpenedLinkCreateAttributesType = {};
 export type LinkCreateUnhandledErrorCaughtAttributesType = {
     browserInfo: string;
     error: string;
-    componentStack: string | null;
+    componentStack?: string | null;
 };
 export type ObjectCreatedLinkCreateAttributesType = {
     objectId: string;
@@ -39,13 +39,13 @@ export type ObjectCreateFailedLinkCreateAttributesType = {
     failureType: string;
 };
 export type LinkCreateExperienceFailedAttributesType = {
-    errorType: string | null;
-    errorMessage: string | null;
+    errorType?: string | null;
+    errorMessage?: string | null;
     experienceStatus: 'SUCCEEDED' | 'FAILED';
     previousExperienceStatus: 'STARTED' | 'SUCCEEDED' | 'FAILED';
-    path: string | null;
-    status: number | null;
-    traceId: string | null;
+    path?: string | null;
+    status?: number | null;
+    traceId?: string | null;
     isSLOFailure: boolean;
 };
 export type AnalyticsEventAttributes = {
@@ -63,19 +63,13 @@ export type AnalyticsEventAttributes = {
     'track.object.createFailed.linkCreate': ObjectCreateFailedLinkCreateAttributesType;
     'operational.linkCreateExperience.failed': LinkCreateExperienceFailedAttributesType;
 };
-declare function createEventPayload<K extends keyof AnalyticsEventAttributes>(eventKey: K, attributes: AnalyticsEventAttributes[K]): {
+type CreateEventPayloadResult<K extends keyof AnalyticsEventAttributes> = {
     eventType: string;
-    name: string | undefined;
     action: string;
     attributes: AnalyticsEventAttributes[K];
-    actionSubject?: undefined;
-    actionSubjectId?: undefined;
-} | {
-    eventType: string | undefined;
-    actionSubject: string | undefined;
-    actionSubjectId: string | undefined;
-    action: string | undefined;
-    attributes: AnalyticsEventAttributes[K];
-    name?: undefined;
+    name?: string;
+    actionSubject?: string;
+    actionSubjectId?: string;
 };
+declare function createEventPayload<K extends keyof AnalyticsEventAttributes>(eventKey: K, attributes: AnalyticsEventAttributes[K]): CreateEventPayloadResult<K>;
 export default createEventPayload;

package/link-create.docs.tsx

@@ -0,0 +1,346 @@
+/**
+ * Testing structured MCP docs for review — ignore this file.
+ * Contact #dst-structured-content in Slack with questions.
+ */
+
+import path from 'path';
+
+import type { ComponentStructuredContentSource } from '@atlassian/structured-docs-types';
+
+import packageJson from './package.json';
+
+const packagePath = path.resolve(__dirname);
+
+const documentation: ComponentStructuredContentSource[] = [
+	{
+		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: '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.',
+		],
+		contentGuidelines: [],
+		accessibilityGuidelines: [],
+		keywords: ['link-create', 'hooks', 'callback', 'useLinkCreateCallback'],
+		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: '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.',
+		],
+		contentGuidelines: [],
+		accessibilityGuidelines: [],
+		keywords: ['link-create', 'hooks', 'exit', 'warning', 'useWithExitWarning'],
+		categories: ['linking', 'forms'],
+		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: [],
+	},
+];
+
+export default documentation;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/link-create",
-	"version": "5.0.1",
+	"version": "5.1.1",
 	"description": "The driver component of meta creation flow",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -44,22 +44,22 @@
 		"@atlaskit/atlassian-context": "^0.8.0",
 		"@atlaskit/button": "^23.11.0",
 		"@atlaskit/css": "^0.19.0",
-		"@atlaskit/empty-state": "^10.1.0",
+		"@atlaskit/empty-state": "^10.2.0",
 		"@atlaskit/form": "^15.5.0",
-		"@atlaskit/icon": "^34.1.0",
+		"@atlaskit/icon": "^34.4.0",
 		"@atlaskit/icon-file-type": "^7.0.0",
-		"@atlaskit/icon-object": "^7.5.0",
-		"@atlaskit/intl-messages-provider": "^3.0.0",
+		"@atlaskit/intl-messages-provider": "^3.2.0",
 		"@atlaskit/link": "^3.4.0",
 		"@atlaskit/linking-common": "^9.11.0",
-		"@atlaskit/modal-dialog": "^14.15.0",
+		"@atlaskit/modal-dialog": "^15.0.0",
+		"@atlaskit/object": "^1.0.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/primitives": "^19.0.0",
 		"@atlaskit/select": "^21.10.0",
 		"@atlaskit/smart-user-picker": "^10.0.0",
 		"@atlaskit/spinner": "^19.1.0",
 		"@atlaskit/textfield": "^8.3.0",
-		"@atlaskit/theme": "^23.0.0",
+		"@atlaskit/theme": "^23.2.0",
 		"@atlaskit/tokens": "^13.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
@@ -75,12 +75,13 @@
 		"@af/accessibility-testing": "workspace:^",
 		"@af/integration-testing": "workspace:^",
 		"@af/visual-regression": "workspace:^",
-		"@atlaskit/drawer": "^12.0.0",
-		"@atlaskit/link-test-helpers": "^10.0.0",
-		"@atlaskit/popup": "^4.16.0",
+		"@atlaskit/drawer": "^12.1.0",
+		"@atlaskit/link-test-helpers": "^10.2.0",
+		"@atlaskit/popup": "^4.17.0",
 		"@atlassian/a11y-jest-testing": "^0.11.0",
 		"@atlassian/feature-flags-test-utils": "^1.0.0",
 		"@atlassian/react-compiler-gating": "workspace:^",
+		"@atlassian/structured-docs-types": "workspace:^",
 		"@testing-library/react": "^16.3.0",
 		"@testing-library/user-event": "^14.4.3",
 		"@types/debounce-promise": "^3.1.2",
@@ -128,10 +129,6 @@
 			]
 		}
 	},
-	"platform-feature-flags": {
-		"dst-a11y__replace-anchor-with-link__linking-platfo": {
-			"type": "boolean"
-		}
-	},
+	"platform-feature-flags": {},
 	"compassUnitTestMetricSourceId": "ari:cloud:compass:a436116f-02ce-4520-8fbb-7301462a1674:metric-source/c5751cc6-3513-4070-9deb-af31e86aed34/5ebc0bfb-9b6d-4ec0-adbe-e4d5e88ace44"
 }