@atlaskit/editor-common 126.2.1 → 126.3.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @atlaskit/editor-common
 
+## 126.3.0
+
+### Minor Changes
+
+- [`cba52821a44c9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/cba52821a44c9) -
+  Add suggestion generation, lifecycle timing, remix-type, and stale-regeneration analytics for
+  suggested edits.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 126.2.2
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 126.2.1
 
 ### Patch Changes

package/dist/cjs/analytics/types/enums.js

@@ -80,6 +80,7 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["UNDO_PERFORMED"] = "undo";
   ACTION["REDO_PERFORMED"] = "redo";
   ACTION["FORMATTED"] = "formatted";
+  ACTION["GENERATED"] = "generated";
   ACTION["HELP_OPENED"] = "helpOpened";
   ACTION["HIGHLIGHTED"] = "highlighted";
   ACTION["INCREMENTED"] = "incremented";
@@ -124,6 +125,8 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["REFERENCE_SYNCED_BLOCK_UPDATE"] = "referenceSyncedBlockUpdate";
   ACTION["REFERENCE_SYNCED_BLOCK_UNSYNC"] = "referenceSyncedBlockUnsync";
   ACTION["REFERENCE_SYNCED_BLOCK_COPY"] = "referenceSyncedBlockCopy";
+  ACTION["REGENERATION_COMPLETED"] = "regenerationCompleted";
+  ACTION["REGENERATION_STARTED"] = "regenerationStarted";
   ACTION["RIGHT_RAIL_CLOSED"] = "rightRailClosed";
   ACTION["RIGHT_RAIL_VIEWED"] = "rightRailViewed";
   ACTION["REPLACED_ALL"] = "replacedAll";
@@ -448,6 +451,7 @@ var ACTION_SUBJECT_ID = exports.ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTIO
   ACTION_SUBJECT_ID["CODEBLOCK_COPY"] = "codeBlockCopy";
   ACTION_SUBJECT_ID["CODEBLOCK_WRAP"] = "codeBlockWrap";
   ACTION_SUBJECT_ID["CONVERSATION_ERROR"] = "conversationError";
+  ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION"] = "suggestionsRegeneration";
   ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION_ERROR"] = "suggestionsRegenerationError";
   ACTION_SUBJECT_ID["SUGGESTIONS_ERROR_RETRY"] = "suggestionsErrorRetry";
   ACTION_SUBJECT_ID["COPY_BUTTON"] = "copyButton";

package/dist/cjs/commands/index.js

@@ -45,11 +45,11 @@ function createParagraphAtEnd() {
   };
 }
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based image alignment retained for legacy alignment call sites.
  *
- * @deprecated use changeImageAlignmentTr instead
+ * @deprecated use changeImageAlignmentNext instead
  */
 var changeImageAlignment = exports.changeImageAlignment = function changeImageAlignment(align) {
   return function (state, dispatch) {
@@ -96,9 +96,9 @@ var changeImageAlignmentNext = exports.changeImageAlignmentNext = function chang
   };
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based block-mark updates retained for media linking and toggleBlockMark.
  *
  * @deprecated use createToggleBlockMarkOnRangeNext instead, which does not require passing editorState
  */
@@ -181,15 +181,16 @@ var createToggleInlineMarkOnRange = exports.createToggleInlineMarkOnRange = func
   };
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
- * @deprecated use toggleBlockMarkTr instead
  * Toggles block mark based on the return type of `getAttrs`.
  * This is similar to ProseMirror's `getAttrs` from `AttributeSpec`
  * return `false` to remove the mark.
- * return `undefined for no-op.
+ * return `undefined` for no-op.
  * return an `object` to update the mark.
+ * Retained for Command-based alignment and indentation paths.
+ *
+ * @deprecated use toggleBlockMarkNext instead
  */
 var toggleBlockMark = exports.toggleBlockMark = function toggleBlockMark(markType, getAttrs, allowedBlocks) {
   return function (state, dispatch) {

package/dist/cjs/monitoring/error.js

@@ -27,7 +27,7 @@ var NETWORK_FAILURE_REGEX = /^network failure/i;
 var RESIZE_OBSERVER_LOOP_REGEX = /ResizeObserver loop completed with undelivered notifications/;
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "126.2.0";
+var packageVersion = "126.2.2";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/ui/DropList/index.js

@@ -24,7 +24,7 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * @jsx jsx
  */ // eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "126.2.0";
+var packageVersion = "126.2.2";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

package/dist/es2019/analytics/types/enums.js

@@ -76,6 +76,7 @@ export let ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["UNDO_PERFORMED"] = "undo";
   ACTION["REDO_PERFORMED"] = "redo";
   ACTION["FORMATTED"] = "formatted";
+  ACTION["GENERATED"] = "generated";
   ACTION["HELP_OPENED"] = "helpOpened";
   ACTION["HIGHLIGHTED"] = "highlighted";
   ACTION["INCREMENTED"] = "incremented";
@@ -120,6 +121,8 @@ export let ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["REFERENCE_SYNCED_BLOCK_UPDATE"] = "referenceSyncedBlockUpdate";
   ACTION["REFERENCE_SYNCED_BLOCK_UNSYNC"] = "referenceSyncedBlockUnsync";
   ACTION["REFERENCE_SYNCED_BLOCK_COPY"] = "referenceSyncedBlockCopy";
+  ACTION["REGENERATION_COMPLETED"] = "regenerationCompleted";
+  ACTION["REGENERATION_STARTED"] = "regenerationStarted";
   ACTION["RIGHT_RAIL_CLOSED"] = "rightRailClosed";
   ACTION["RIGHT_RAIL_VIEWED"] = "rightRailViewed";
   ACTION["REPLACED_ALL"] = "replacedAll";
@@ -456,6 +459,7 @@ export let ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTION_SUBJECT_ID) {
   ACTION_SUBJECT_ID["CODEBLOCK_COPY"] = "codeBlockCopy";
   ACTION_SUBJECT_ID["CODEBLOCK_WRAP"] = "codeBlockWrap";
   ACTION_SUBJECT_ID["CONVERSATION_ERROR"] = "conversationError";
+  ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION"] = "suggestionsRegeneration";
   ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION_ERROR"] = "suggestionsRegenerationError";
   ACTION_SUBJECT_ID["SUGGESTIONS_ERROR_RETRY"] = "suggestionsErrorRetry";
   ACTION_SUBJECT_ID["COPY_BUTTON"] = "copyButton";

package/dist/es2019/commands/index.js

@@ -36,11 +36,11 @@ export function createParagraphAtEnd() {
   };
 }
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based image alignment retained for legacy alignment call sites.
  *
- * @deprecated use changeImageAlignmentTr instead
+ * @deprecated use changeImageAlignmentNext instead
  */
 export const changeImageAlignment = align => (state, dispatch) => {
   const {
@@ -87,9 +87,9 @@ export const changeImageAlignmentNext = align => tr => {
   return false;
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based block-mark updates retained for media linking and toggleBlockMark.
  *
  * @deprecated use createToggleBlockMarkOnRangeNext instead, which does not require passing editorState
  */
@@ -154,15 +154,16 @@ export const createToggleInlineMarkOnRange = (markType, getAttrs) => (from, to,
   return markApplied;
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
- * @deprecated use toggleBlockMarkTr instead
  * Toggles block mark based on the return type of `getAttrs`.
  * This is similar to ProseMirror's `getAttrs` from `AttributeSpec`
  * return `false` to remove the mark.
- * return `undefined for no-op.
+ * return `undefined` for no-op.
  * return an `object` to update the mark.
+ * Retained for Command-based alignment and indentation paths.
+ *
+ * @deprecated use toggleBlockMarkNext instead
  */
 export const toggleBlockMark = (markType, getAttrs, allowedBlocks) => (state, dispatch) => {
   let markApplied = false;

package/dist/es2019/monitoring/error.js

@@ -13,7 +13,7 @@ const NETWORK_FAILURE_REGEX = /^network failure/i;
 const RESIZE_OBSERVER_LOOP_REGEX = /ResizeObserver loop completed with undelivered notifications/;
 const SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 const packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-const packageVersion = "126.2.0";
+const packageVersion = "126.2.2";
 const sanitiseSentryEvents = (data, _hint) => {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/es2019/ui/DropList/index.js

@@ -14,7 +14,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Layer from '../Layer';
 const packageName = "@atlaskit/editor-common";
-const packageVersion = "126.2.0";
+const packageVersion = "126.2.2";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

package/dist/esm/analytics/types/enums.js

@@ -76,6 +76,7 @@ export var ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["UNDO_PERFORMED"] = "undo";
   ACTION["REDO_PERFORMED"] = "redo";
   ACTION["FORMATTED"] = "formatted";
+  ACTION["GENERATED"] = "generated";
   ACTION["HELP_OPENED"] = "helpOpened";
   ACTION["HIGHLIGHTED"] = "highlighted";
   ACTION["INCREMENTED"] = "incremented";
@@ -120,6 +121,8 @@ export var ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["REFERENCE_SYNCED_BLOCK_UPDATE"] = "referenceSyncedBlockUpdate";
   ACTION["REFERENCE_SYNCED_BLOCK_UNSYNC"] = "referenceSyncedBlockUnsync";
   ACTION["REFERENCE_SYNCED_BLOCK_COPY"] = "referenceSyncedBlockCopy";
+  ACTION["REGENERATION_COMPLETED"] = "regenerationCompleted";
+  ACTION["REGENERATION_STARTED"] = "regenerationStarted";
   ACTION["RIGHT_RAIL_CLOSED"] = "rightRailClosed";
   ACTION["RIGHT_RAIL_VIEWED"] = "rightRailViewed";
   ACTION["REPLACED_ALL"] = "replacedAll";
@@ -456,6 +459,7 @@ export var ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTION_SUBJECT_ID) {
   ACTION_SUBJECT_ID["CODEBLOCK_COPY"] = "codeBlockCopy";
   ACTION_SUBJECT_ID["CODEBLOCK_WRAP"] = "codeBlockWrap";
   ACTION_SUBJECT_ID["CONVERSATION_ERROR"] = "conversationError";
+  ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION"] = "suggestionsRegeneration";
   ACTION_SUBJECT_ID["SUGGESTIONS_REGENERATION_ERROR"] = "suggestionsRegenerationError";
   ACTION_SUBJECT_ID["SUGGESTIONS_ERROR_RETRY"] = "suggestionsErrorRetry";
   ACTION_SUBJECT_ID["COPY_BUTTON"] = "copyButton";

package/dist/esm/commands/index.js

@@ -27,11 +27,11 @@ export function createParagraphAtEnd() {
   };
 }
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based image alignment retained for legacy alignment call sites.
  *
- * @deprecated use changeImageAlignmentTr instead
+ * @deprecated use changeImageAlignmentNext instead
  */
 export var changeImageAlignment = function changeImageAlignment(align) {
   return function (state, dispatch) {
@@ -78,9 +78,9 @@ export var changeImageAlignmentNext = function changeImageAlignmentNext(align) {
   };
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
+ * Command-based block-mark updates retained for media linking and toggleBlockMark.
  *
  * @deprecated use createToggleBlockMarkOnRangeNext instead, which does not require passing editorState
  */
@@ -163,15 +163,16 @@ export var createToggleInlineMarkOnRange = function createToggleInlineMarkOnRang
   };
 };
 
-// Remove this when cleaning up platform_editor_toolbar_aifc
 // eslint-disable-next-line @repo/internal/deprecations/deprecation-ticket-required
 /**
- * @deprecated use toggleBlockMarkTr instead
  * Toggles block mark based on the return type of `getAttrs`.
  * This is similar to ProseMirror's `getAttrs` from `AttributeSpec`
  * return `false` to remove the mark.
- * return `undefined for no-op.
+ * return `undefined` for no-op.
  * return an `object` to update the mark.
+ * Retained for Command-based alignment and indentation paths.
+ *
+ * @deprecated use toggleBlockMarkNext instead
  */
 export var toggleBlockMark = function toggleBlockMark(markType, getAttrs, allowedBlocks) {
   return function (state, dispatch) {

package/dist/esm/monitoring/error.js

@@ -19,7 +19,7 @@ var NETWORK_FAILURE_REGEX = /^network failure/i;
 var RESIZE_OBSERVER_LOOP_REGEX = /ResizeObserver loop completed with undelivered notifications/;
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "126.2.0";
+var packageVersion = "126.2.2";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/esm/ui/DropList/index.js

@@ -21,7 +21,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Layer from '../Layer';
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "126.2.0";
+var packageVersion = "126.2.2";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

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

@@ -58,4 +58,4 @@ export { type TelepointerClickPayload } from './types/telepointer-events';
 export type { BlockMenuEventPayload } from './types/block-menu-events';
 export type { BreakoutEventPayload, BreakoutSupportedNodes } from './types/breakout-events';
 export type { RendererSyncBlockEventPayload, SyncBlockEventPayload, SyncedBlockSSRErrorAEP, } from './types/sync-block-events';
-export type { AiSuggestionsConversationErrorReason, AiSuggestionInteractionPoint, AiSuggestionsEntryPoint, AiSuggestionsEventPayload, AiSuggestionsEmptyStateType, AiSuggestionsRightRailEntryPoint, } from './types/ai-suggestions-events';
+export type { AiSuggestionsConversationErrorReason, AiSuggestionInteractionPoint, AiSuggestionsEntryPoint, AiSuggestionsEventPayload, AiSuggestionsEmptyStateType, AiSuggestionsRegenerationOutcome, AiSuggestionsRegenerationTrigger, AiSuggestionsRightRailEntryPoint, } from './types/ai-suggestions-events';

package/dist/types/analytics/types/ai-suggestions-events.d.ts

@@ -21,6 +21,27 @@ export type AiSuggestionInteractionPoint = 'sidebar' | 'card' | 'statusBar';
 export type AiSuggestionsRightRailEntryPoint = 'suggestionsPanel' | 'suggestionsTab' | 'suggestionCard';
 export type AiSuggestionsEmptyStateType = 'initial' | 'noSuggestionsFound' | 'suggestionsResolved';
 export type AiSuggestionsConversationErrorReason = 'agentDeactivated' | 'agentProvisioning' | 'agentExternalConfigReference' | 'conversationSetup' | 'streamError';
+export type AiSuggestionsRegenerationTrigger = 'panelOpen' | 'reviewCompleted' | 'suggestionSelected' | 'suggestionsUpdated';
+export type AiSuggestionsRegenerationOutcome = 'removed' | 'stillStale' | 'updated';
+type SuggestionRemixAttributes = {
+    remixSubtype?: string;
+    remixType?: string;
+};
+type SuggestionAgeAttribute = {
+    suggestionAgeMs?: number;
+};
+type RegenerationSuggestionDetails = SuggestionRemixAttributes & SuggestionAgeAttribute & {
+    actionKind: string;
+    outcome?: AiSuggestionsRegenerationOutcome;
+    suggestionId: string;
+    suggestionType: string;
+};
+type RegenerationCommonAttributes = {
+    currentNodeCount: number;
+    staleSuggestionCount: number;
+    suggestionDetails: RegenerationSuggestionDetails[];
+    trigger: AiSuggestionsRegenerationTrigger;
+};
 type NoDiffSuggestionAEP = OperationalAEP<ACTION.NO_DIFF_FOUND, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     suggestionType: string;
     toolCalls: {
@@ -34,12 +55,18 @@ type ConversationErrorAEP = OperationalAEP<ACTION.ERRORED, ACTION_SUBJECT.AI_SUG
     reason: AiSuggestionsConversationErrorReason;
     statusCode?: number;
 }>;
-type RegenerateSuggestionsErrorAEP = OperationalAEP<ACTION.ERRORED, ACTION_SUBJECT.AI_SUGGESTIONS, ACTION_SUBJECT_ID.SUGGESTIONS_REGENERATION_ERROR, {
-    currentNodeCount: number;
+type RegenerateSuggestionsErrorAEP = OperationalAEP<ACTION.ERRORED, ACTION_SUBJECT.AI_SUGGESTIONS, ACTION_SUBJECT_ID.SUGGESTIONS_REGENERATION_ERROR, RegenerationCommonAttributes & {
     errorCode?: string;
-    staleSuggestionCount: number;
+    regenerationDurationMs: number;
     statusCode?: number;
 }>;
+type RegenerateSuggestionsStartedAEP = OperationalAEP<ACTION.REGENERATION_STARTED, ACTION_SUBJECT.AI_SUGGESTIONS, ACTION_SUBJECT_ID.SUGGESTIONS_REGENERATION, RegenerationCommonAttributes>;
+type RegenerateSuggestionsCompletedAEP = OperationalAEP<ACTION.REGENERATION_COMPLETED, ACTION_SUBJECT.AI_SUGGESTIONS, ACTION_SUBJECT_ID.SUGGESTIONS_REGENERATION, RegenerationCommonAttributes & {
+    regenerationDurationMs: number;
+    removedSuggestionCount: number;
+    stillStaleSuggestionCount: number;
+    updatedSuggestionCount: number;
+}>;
 type EntryPointClickedAEP = TrackAEP<ACTION.CLICKED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     entryPoint: AiSuggestionsEntryPoint;
 }, undefined>;
@@ -52,18 +79,7 @@ type SuggestionsErrorRetryClickedAEP = TrackAEP<ACTION.CLICKED, ACTION_SUBJECT.A
 type EntryPointExposureAEP = TrackAEP<ACTION.EXPOSED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     entryPoint: AiSuggestionsEntryPoint;
 }, undefined>;
-type AcceptSuggestionAEP = TrackAEP<ACTION.ACCEPTED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
-    affectedBlocks: number;
-    agentId?: string;
-    charactersAdded?: number;
-    charactersRemoved?: number;
-    hasSources: boolean;
-    interactionPoint: AiSuggestionInteractionPoint;
-    isDiffHidden: boolean;
-    suggestionId: string;
-    suggestionType: string;
-}, undefined>;
-type DiscardedSuggestionAttributes = {
+type SuggestionLifecycleAttributes = SuggestionRemixAttributes & SuggestionAgeAttribute & {
     actionKind: string;
     affectedBlocks: number;
     agentId?: string;
@@ -72,6 +88,12 @@ type DiscardedSuggestionAttributes = {
     suggestionId: string;
     suggestionType: string;
 };
+type AcceptSuggestionAEP = TrackAEP<ACTION.ACCEPTED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, SuggestionLifecycleAttributes & {
+    charactersAdded?: number;
+    charactersRemoved?: number;
+    isDiffHidden: boolean;
+}, undefined>;
+type DiscardedSuggestionAttributes = SuggestionLifecycleAttributes;
 type CancelSuggestionsAEP = TrackAEP<ACTION.CANCELLED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     interactionPoint: AiSuggestionInteractionPoint;
 }, undefined>;
@@ -80,45 +102,48 @@ type DiscardAllSuggestionsAEP = TrackAEP<ACTION.DISCARD_ALL, ACTION_SUBJECT.AI_S
     numberOfSuggestions: number;
     suggestionDetails: DiscardedSuggestionAttributes[];
 }, undefined>;
-type DismissSuggestionAEP = TrackAEP<ACTION.DISMISSED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
-    affectedBlocks: number;
-    hasSources: boolean;
-    interactionPoint: AiSuggestionInteractionPoint;
-    suggestionId: string;
-    suggestionType: string;
-}, undefined>;
-type ViewSuggestionAEP = TrackAEP<ACTION.VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
-    actionKind: string;
-    affectedBlocks: number;
-    agentId?: string;
+type DismissSuggestionAEP = TrackAEP<ACTION.DISMISSED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, SuggestionLifecycleAttributes, undefined>;
+type ViewSuggestionAEP = TrackAEP<ACTION.VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, SuggestionLifecycleAttributes & {
     blockTypes: string[];
     charactersToAdd?: number;
     charactersToRemove?: number;
-    hasSources: boolean;
-    interactionPoint: AiSuggestionInteractionPoint;
     suggestionCardCharacterCount: number;
-    suggestionId: string;
-    suggestionType: string;
 }, undefined>;
 type RightRailViewedAEP = TrackAEP<ACTION.RIGHT_RAIL_VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     entryPoint: AiSuggestionsRightRailEntryPoint;
     numberOfSuggestions: number;
-    suggestionDetails: Array<{
+    suggestionDetails: Array<SuggestionRemixAttributes & SuggestionAgeAttribute & {
         actionKind: string;
         affectedBlocks: number;
         suggestionType: string;
     }>;
 }, undefined>;
 type RightRailClosedAEP = TrackAEP<ACTION.RIGHT_RAIL_CLOSED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, undefined, undefined>;
-type ViewSuggestionReasoningAEP = TrackAEP<ACTION.REASONING_VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
+type ViewSuggestionReasoningAEP = TrackAEP<ACTION.REASONING_VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, SuggestionRemixAttributes & SuggestionAgeAttribute & {
+    actionKind: string;
     affectedBlocks: number;
+    agentId?: string;
     hasSources: boolean;
     interactionPoint: AiSuggestionInteractionPoint;
     reasoningCharacterCount: number;
+    suggestionId: string;
     suggestionType: string;
 }, undefined>;
+type SuggestionsGeneratedAEP = TrackAEP<ACTION.GENERATED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
+    generationDurationMs: number;
+    hadExistingSuggestions: boolean;
+    numberOfSuggestions: number;
+    suggestionDetails: Array<SuggestionRemixAttributes & {
+        actionKind: string;
+        affectedBlocks: number;
+        agentId?: string;
+        hasSources: boolean;
+        suggestionId: string;
+        suggestionType: string;
+    }>;
+}, undefined>;
 type EmptyStateExposedAEP = TrackAEP<ACTION.EMPTY_STATE_EXPOSED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
     emptyStateType: AiSuggestionsEmptyStateType;
 }, undefined>;
-export type AiSuggestionsEventPayload = NoDiffSuggestionAEP | ConversationErrorAEP | RegenerateSuggestionsErrorAEP | EntryPointClickedAEP | SuggestionsErrorRetryClickedAEP | EntryPointExposureAEP | CancelSuggestionsAEP | AcceptSuggestionAEP | DiscardSuggestionAEP | DiscardAllSuggestionsAEP | DismissSuggestionAEP | ViewSuggestionAEP | RightRailViewedAEP | RightRailClosedAEP | ViewSuggestionReasoningAEP | EmptyStateExposedAEP;
+export type AiSuggestionsEventPayload = NoDiffSuggestionAEP | ConversationErrorAEP | RegenerateSuggestionsErrorAEP | RegenerateSuggestionsStartedAEP | RegenerateSuggestionsCompletedAEP | EntryPointClickedAEP | SuggestionsErrorRetryClickedAEP | EntryPointExposureAEP | CancelSuggestionsAEP | AcceptSuggestionAEP | DiscardSuggestionAEP | DiscardAllSuggestionsAEP | DismissSuggestionAEP | ViewSuggestionAEP | RightRailViewedAEP | RightRailClosedAEP | ViewSuggestionReasoningAEP | SuggestionsGeneratedAEP | EmptyStateExposedAEP;
 export {};

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

@@ -73,6 +73,7 @@ export declare enum ACTION {
     UNDO_PERFORMED = "undo",
     REDO_PERFORMED = "redo",
     FORMATTED = "formatted",
+    GENERATED = "generated",
     HELP_OPENED = "helpOpened",
     HIGHLIGHTED = "highlighted",
     INCREMENTED = "incremented",
@@ -117,6 +118,8 @@ export declare enum ACTION {
     REFERENCE_SYNCED_BLOCK_UPDATE = "referenceSyncedBlockUpdate",
     REFERENCE_SYNCED_BLOCK_UNSYNC = "referenceSyncedBlockUnsync",
     REFERENCE_SYNCED_BLOCK_COPY = "referenceSyncedBlockCopy",
+    REGENERATION_COMPLETED = "regenerationCompleted",
+    REGENERATION_STARTED = "regenerationStarted",
     RIGHT_RAIL_CLOSED = "rightRailClosed",
     RIGHT_RAIL_VIEWED = "rightRailViewed",
     REPLACED_ALL = "replacedAll",
@@ -431,6 +434,7 @@ export declare enum ACTION_SUBJECT_ID {
     CODEBLOCK_COPY = "codeBlockCopy",
     CODEBLOCK_WRAP = "codeBlockWrap",
     CONVERSATION_ERROR = "conversationError",
+    SUGGESTIONS_REGENERATION = "suggestionsRegeneration",
     SUGGESTIONS_REGENERATION_ERROR = "suggestionsRegenerationError",
     SUGGESTIONS_ERROR_RETRY = "suggestionsErrorRetry",
     COPY_BUTTON = "copyButton",

package/dist/types/commands/index.d.ts

@@ -6,32 +6,36 @@ type AlignmentState = 'start' | 'end' | 'center';
 export declare function addParagraphAtEnd(tr: Transaction): void;
 export declare function createParagraphAtEnd(): Command;
 /**
+ * Command-based image alignment retained for legacy alignment call sites.
  *
- * @deprecated use changeImageAlignmentTr instead
+ * @deprecated use changeImageAlignmentNext instead
  */
 export declare const changeImageAlignment: (align?: AlignmentState) => Command;
 export declare const changeImageAlignmentNext: (align?: AlignmentState) => (tr: Transaction) => boolean;
 /**
+ * Command-based block-mark updates retained for media linking and toggleBlockMark.
  *
  * @deprecated use createToggleBlockMarkOnRangeNext instead, which does not require passing editorState
  */
-export declare const createToggleBlockMarkOnRange: <T extends Object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (from: number, to: number, tr: Transaction, state: EditorState) => boolean;
-export declare const createToggleBlockMarkOnRangeNext: <T extends Object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (from: number, to: number, tr: Transaction) => boolean;
-export declare const createToggleInlineMarkOnRange: <T extends Object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false) => (from: number, to: number, tr: Transaction, state: EditorState) => boolean;
+export declare const createToggleBlockMarkOnRange: <T extends object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (from: number, to: number, tr: Transaction, state: EditorState) => boolean;
+export declare const createToggleBlockMarkOnRangeNext: <T extends object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (from: number, to: number, tr: Transaction) => boolean;
+export declare const createToggleInlineMarkOnRange: <T extends object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false) => (from: number, to: number, tr: Transaction, state: EditorState) => boolean;
 /**
- * @deprecated use toggleBlockMarkTr instead
  * Toggles block mark based on the return type of `getAttrs`.
  * This is similar to ProseMirror's `getAttrs` from `AttributeSpec`
  * return `false` to remove the mark.
- * return `undefined for no-op.
+ * return `undefined` for no-op.
  * return an `object` to update the mark.
+ * Retained for Command-based alignment and indentation paths.
+ *
+ * @deprecated use toggleBlockMarkNext instead
  */
-export declare const toggleBlockMark: <T extends Object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => Command;
+export declare const toggleBlockMark: <T extends object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => Command;
 /**
  * Toggles block mark based on the return type of `getAttrs`.
  * @returns true if the mark is applied, false otherwise.
  */
-export declare const toggleBlockMarkNext: <T extends Object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (tr: Transaction) => boolean;
+export declare const toggleBlockMarkNext: <T extends object = object>(markType: MarkType, getAttrs: (prevAttrs?: T, node?: PMNode) => T | undefined | false, allowedBlocks?: Array<NodeType> | ((schema: Schema, node: PMNode, parent: PMNode | null) => boolean)) => (tr: Transaction) => boolean;
 export declare const clearEditorContent: Command;
 export declare function findCutBefore($pos: ResolvedPos): ResolvedPos | null;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "126.2.1",
+	"version": "126.3.0",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -41,7 +41,7 @@
 		"@atlaskit/codemod-utils": "^5.1.0",
 		"@atlaskit/css": "^1.1.0",
 		"@atlaskit/custom-steps": "^1.1.0",
-		"@atlaskit/dropdown-menu": "^18.3.0",
+		"@atlaskit/dropdown-menu": "^19.0.0",
 		"@atlaskit/editor-json-transformer": "^10.0.0",
 		"@atlaskit/editor-palette": "^3.5.0",
 		"@atlaskit/editor-prosemirror": "^9.0.0",
@@ -85,7 +85,7 @@
 		"@atlaskit/task-decision": "^21.11.0",
 		"@atlaskit/teams-app-config": "^3.1.0",
 		"@atlaskit/textfield": "^10.2.0",
-		"@atlaskit/tmp-editor-statsig": "^213.0.0",
+		"@atlaskit/tmp-editor-statsig": "^215.0.0",
 		"@atlaskit/tokens": "^20.1.0",
 		"@atlaskit/tooltip": "^24.3.0",
 		"@atlaskit/width-detector": "^7.2.0",