@atlaskit/editor-common 126.0.0 → 126.1.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @atlaskit/editor-common
 
+## 126.1.0
+
+### Minor Changes
+
+- [`5b30c74e8080f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/5b30c74e8080f) -
+  Compose the intermediate steps of an AI streaming response into a single collab step, so a
+  streamed edit costs the collab service roughly one step per block instead of one per chunk.
+
+  Each streaming frame replaces the whole AI region with the cumulative content so far, so the
+  frames are individually large and grow as the response does. They are also thrown away at the end
+  — `buildCommitTransaction` rebuilds the final document from the response rather than from what was
+  streamed — which is what makes composing them safe.
+
+  `mergeOverlappingSteps` merges two consecutive overlapping steps into the single step they are
+  collectively equivalent to, and `collapseStreamingSteps` folds it across the steps in the collab
+  unconfirmed queue. Composition is exact in both directions: the forward step is verified against
+  the document, and the inverse is composed alongside it because `rebaseSteps` applies inverses to
+  the live document whenever a remote step arrives.
+
+  Composing only helps while the steps are still unsent, because `lockStepOrigins` marks everything
+  a flush sends and a locked step can never be merged. `createCollabSendHold` therefore holds the
+  send back across transactions — not per transaction, since acks, remote steps and the user's own
+  typing all trigger sends that would otherwise lock the queue. Producers drive it with the
+  `DEFER_COLLAB_SEND` meta: `true` starts the hold, `false` releases it, anything else leaves it
+  untouched. `true` does not extend a hold already in progress, so a continuous stream of held
+  frames still reaches the bound.
+
+  `editor-common` gains two new entrypoints for the metadata keys shared between the producer and
+  the collab layer: `./collab-streaming-step-collapse` and `./collab-defer-collab-send`. The changes
+  in `editor-plugin-collab-edit` and `editor-plugin-ai` are internal — neither package's exports map
+  changes.
+
+  While the send is held nothing is sent, including the user's own edits, up to the hold's time
+  bound. `sendableSteps` returns the queue in version order, so a later step cannot be sent ahead of
+  held ones. Peers also do not see in-progress content until a flush, and content in a held queue
+  exists only on the client until then.
+
+  All of this is behind the `platform_editor_ai_collapse_streaming_steps` feature gate. With the
+  gate off, streaming frames are not stamped, the send is never held, and the unconfirmed queue is
+  left exactly as it is today.
+
+### Patch Changes
+
+- [`5f61320693517`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/5f61320693517) -
+  Clean up experiment `platform_editor_remove_collab_step_metrics`
+- Updated dependencies
+
 ## 126.0.0
 
 ### Major Changes

package/collab-defer-collab-send/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@atlaskit/editor-common/collab-defer-collab-send",
+  "main": "../dist/cjs/collab/defer-collab-send.js",
+  "module": "../dist/esm/collab/defer-collab-send.js",
+  "module:es2019": "../dist/es2019/collab/defer-collab-send.js",
+  "sideEffects": [
+    "**/*.compiled.css"
+  ],
+  "types": "../dist/types/collab/defer-collab-send.d.ts"
+}

package/collab-streaming-step-collapse/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@atlaskit/editor-common/collab-streaming-step-collapse",
+  "main": "../dist/cjs/collab/streaming-step-collapse.js",
+  "module": "../dist/esm/collab/streaming-step-collapse.js",
+  "module:es2019": "../dist/es2019/collab/streaming-step-collapse.js",
+  "sideEffects": [
+    "**/*.compiled.css"
+  ],
+  "types": "../dist/types/collab/streaming-step-collapse.d.ts"
+}

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

@@ -197,9 +197,6 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["SELECT_ALL_ESCAPED"] = "selectAllEscaped";
   ACTION["SORT_COLUMN"] = "sortedColumn";
   ACTION["SORT_COLUMN_NOT_ALLOWED"] = "sortColumnNotAllowed";
-  // remove this enum when cleaning up platform_editor_remove_collab_step_metrics
-  ACTION["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  ACTION["STEPS_TRACKED"] = "stepsTracked";
   ACTION["ORGANIC_CHANGES_TRACKED"] = "organicChangesTracked";
   ACTION["STEPS_FILTERED"] = "stepsFiltered";
   ACTION["AGENT_EDIT_SHIMMER_NOT_SHOWN"] = "agentEditShimmerNotShown";

package/dist/cjs/collab/defer-collab-send.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFER_COLLAB_SEND = void 0;
+/**
+ * Neutral transaction metadata used by streaming producers to tell the collab layer not to flush
+ * the unconfirmed queue for this transaction.
+ *
+ * The transaction is still applied to the local document immediately; only the network send is
+ * held back. The steps stay in the collab plugin's unconfirmed queue, which is where sending is
+ * deferred from — `sendableSteps` returns the whole queue, so the next unheld transaction sends
+ * everything that accumulated.
+ *
+ * Holding the send is what gives `collapseStreamingSteps` a window to work in: `send()` stamps
+ * `mergeIsLocked` on every origin it flushes, and locked steps can no longer be composed.
+ *
+ * Producers must bound how long they hold. Held steps are content the collab service has not seen,
+ * so they are lost if the tab closes, and a peer editing the same region while steps are held will
+ * rebase against a document that is missing them.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(DEFER_COLLAB_SEND, true);
+ * ```
+ */
+var DEFER_COLLAB_SEND = exports.DEFER_COLLAB_SEND = 'deferCollabSend';

package/dist/cjs/collab/streaming-step-collapse.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.STREAMING_COLLAPSIBLE_STEPS = void 0;
+/**
+ * Neutral transaction metadata used by streaming producers (for example editor-plugin-ai's
+ * in-editor direct streaming) to tell the collab layer that this transaction's steps are an
+ * intermediate frame of a single logical edit.
+ *
+ * Streaming producers re-render the whole in-progress region on every chunk, which means each
+ * frame is a full replace of the region the previous frame inserted. Every frame is applied to the
+ * local document immediately (so the user sees the content stream in), but only the *composition*
+ * of the frames needs to reach the collab service.
+ *
+ * Stamping a transaction with this meta does NOT stop its steps from being sent — it only makes
+ * them eligible to be composed with adjacent frames while they are still unconfirmed. See
+ * `collapseStreamingSteps` in `@atlaskit/editor-plugin-collab-edit`.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(STREAMING_COLLAPSIBLE_STEPS, true);
+ * ```
+ */
+var STREAMING_COLLAPSIBLE_STEPS = exports.STREAMING_COLLAPSIBLE_STEPS = 'streamingCollapsibleSteps';

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 = "125.4.0";
+var packageVersion = "126.0.0";
 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 = "125.4.0";
+var packageVersion = "126.0.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

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

@@ -193,9 +193,6 @@ export let ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["SELECT_ALL_ESCAPED"] = "selectAllEscaped";
   ACTION["SORT_COLUMN"] = "sortedColumn";
   ACTION["SORT_COLUMN_NOT_ALLOWED"] = "sortColumnNotAllowed";
-  // remove this enum when cleaning up platform_editor_remove_collab_step_metrics
-  ACTION["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  ACTION["STEPS_TRACKED"] = "stepsTracked";
   ACTION["ORGANIC_CHANGES_TRACKED"] = "organicChangesTracked";
   ACTION["STEPS_FILTERED"] = "stepsFiltered";
   ACTION["AGENT_EDIT_SHIMMER_NOT_SHOWN"] = "agentEditShimmerNotShown";

package/dist/es2019/collab/defer-collab-send.js

@@ -0,0 +1,22 @@
+/**
+ * Neutral transaction metadata used by streaming producers to tell the collab layer not to flush
+ * the unconfirmed queue for this transaction.
+ *
+ * The transaction is still applied to the local document immediately; only the network send is
+ * held back. The steps stay in the collab plugin's unconfirmed queue, which is where sending is
+ * deferred from — `sendableSteps` returns the whole queue, so the next unheld transaction sends
+ * everything that accumulated.
+ *
+ * Holding the send is what gives `collapseStreamingSteps` a window to work in: `send()` stamps
+ * `mergeIsLocked` on every origin it flushes, and locked steps can no longer be composed.
+ *
+ * Producers must bound how long they hold. Held steps are content the collab service has not seen,
+ * so they are lost if the tab closes, and a peer editing the same region while steps are held will
+ * rebase against a document that is missing them.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(DEFER_COLLAB_SEND, true);
+ * ```
+ */
+export const DEFER_COLLAB_SEND = 'deferCollabSend';

package/dist/es2019/collab/streaming-step-collapse.js

@@ -0,0 +1,20 @@
+/**
+ * Neutral transaction metadata used by streaming producers (for example editor-plugin-ai's
+ * in-editor direct streaming) to tell the collab layer that this transaction's steps are an
+ * intermediate frame of a single logical edit.
+ *
+ * Streaming producers re-render the whole in-progress region on every chunk, which means each
+ * frame is a full replace of the region the previous frame inserted. Every frame is applied to the
+ * local document immediately (so the user sees the content stream in), but only the *composition*
+ * of the frames needs to reach the collab service.
+ *
+ * Stamping a transaction with this meta does NOT stop its steps from being sent — it only makes
+ * them eligible to be composed with adjacent frames while they are still unconfirmed. See
+ * `collapseStreamingSteps` in `@atlaskit/editor-plugin-collab-edit`.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(STREAMING_COLLAPSIBLE_STEPS, true);
+ * ```
+ */
+export const STREAMING_COLLAPSIBLE_STEPS = 'streamingCollapsibleSteps';

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 = "125.4.0";
+const packageVersion = "126.0.0";
 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 = "125.4.0";
+const packageVersion = "126.0.0";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

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

@@ -193,9 +193,6 @@ export var ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["SELECT_ALL_ESCAPED"] = "selectAllEscaped";
   ACTION["SORT_COLUMN"] = "sortedColumn";
   ACTION["SORT_COLUMN_NOT_ALLOWED"] = "sortColumnNotAllowed";
-  // remove this enum when cleaning up platform_editor_remove_collab_step_metrics
-  ACTION["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  ACTION["STEPS_TRACKED"] = "stepsTracked";
   ACTION["ORGANIC_CHANGES_TRACKED"] = "organicChangesTracked";
   ACTION["STEPS_FILTERED"] = "stepsFiltered";
   ACTION["AGENT_EDIT_SHIMMER_NOT_SHOWN"] = "agentEditShimmerNotShown";

package/dist/esm/collab/defer-collab-send.js

@@ -0,0 +1,22 @@
+/**
+ * Neutral transaction metadata used by streaming producers to tell the collab layer not to flush
+ * the unconfirmed queue for this transaction.
+ *
+ * The transaction is still applied to the local document immediately; only the network send is
+ * held back. The steps stay in the collab plugin's unconfirmed queue, which is where sending is
+ * deferred from — `sendableSteps` returns the whole queue, so the next unheld transaction sends
+ * everything that accumulated.
+ *
+ * Holding the send is what gives `collapseStreamingSteps` a window to work in: `send()` stamps
+ * `mergeIsLocked` on every origin it flushes, and locked steps can no longer be composed.
+ *
+ * Producers must bound how long they hold. Held steps are content the collab service has not seen,
+ * so they are lost if the tab closes, and a peer editing the same region while steps are held will
+ * rebase against a document that is missing them.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(DEFER_COLLAB_SEND, true);
+ * ```
+ */
+export var DEFER_COLLAB_SEND = 'deferCollabSend';

package/dist/esm/collab/streaming-step-collapse.js

@@ -0,0 +1,20 @@
+/**
+ * Neutral transaction metadata used by streaming producers (for example editor-plugin-ai's
+ * in-editor direct streaming) to tell the collab layer that this transaction's steps are an
+ * intermediate frame of a single logical edit.
+ *
+ * Streaming producers re-render the whole in-progress region on every chunk, which means each
+ * frame is a full replace of the region the previous frame inserted. Every frame is applied to the
+ * local document immediately (so the user sees the content stream in), but only the *composition*
+ * of the frames needs to reach the collab service.
+ *
+ * Stamping a transaction with this meta does NOT stop its steps from being sent — it only makes
+ * them eligible to be composed with adjacent frames while they are still unconfirmed. See
+ * `collapseStreamingSteps` in `@atlaskit/editor-plugin-collab-edit`.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(STREAMING_COLLAPSIBLE_STEPS, true);
+ * ```
+ */
+export var STREAMING_COLLAPSIBLE_STEPS = 'streamingCollapsibleSteps';

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 = "125.4.0";
+var packageVersion = "126.0.0";
 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 = "125.4.0";
+var packageVersion = "126.0.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

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

@@ -55,7 +55,6 @@ export type { AIUnifiedEventPayload, AIUnifiedCommonAttributes } from './types/a
 export type { ActiveSessionEventPayload, ActiveSessionEventAttributes, } from './types/activity-session-events';
 export { type AIInlineSuggestionPayload, AI_SUGGESTION_TRIGGERED_FROM, } from './types/ai-inline-suggestion-events';
 export { type TelepointerClickPayload } from './types/telepointer-events';
-export { type NcsSessionStepEventAEP, type NcsSessionStepMetrics, } from './types/ncs-session-step-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';

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

@@ -190,8 +190,6 @@ export declare enum ACTION {
     SELECT_ALL_ESCAPED = "selectAllEscaped",
     SORT_COLUMN = "sortedColumn",
     SORT_COLUMN_NOT_ALLOWED = "sortColumnNotAllowed",
-    NCS_SESSION_STEP_METRICS = "ncsSessionStepMetrics",
-    STEPS_TRACKED = "stepsTracked",
     ORGANIC_CHANGES_TRACKED = "organicChangesTracked",
     STEPS_FILTERED = "stepsFiltered",
     AGENT_EDIT_SHIMMER_NOT_SHOWN = "agentEditShimmerNotShown",

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

@@ -48,7 +48,6 @@ import type { MediaEventPayload } from './media-events';
 import type { MentionEventPayload } from './mention-events';
 import type { MoveContentEventPayload } from './move-content-events';
 import type { NativeEmbedResizeErroredAEP } from './native-embed-events';
-import type { NcsSessionStepEventAEP } from './ncs-session-step-events';
 import type { NestedTableActionsEventPayload } from './nested-table-events';
 import type { NodeEventPayload } from './node-events';
 import type { OfflineEditingEventPayload } from './offline-editing-event';
@@ -74,7 +73,7 @@ export type SimplifiedNode = {
     pos: number;
     type: string;
 };
-export type AnalyticsEventPayload<T = void> = AvatarEventPayload | GeneralEventPayload<T> | FormatEventPayload | SubstituteEventPayload | InsertEventPayload | NodeEventPayload | MoveContentEventPayload | MediaEventPayload | TableEventPayload | PasteEventPayload | PasteActionsMenuEventPayload | QuickInsertInformationEventPayload | CutCopyEventPayload | ErrorEventPayload | TextColorEventPayload | FindReplaceEventPayload | DateEventPayload | SelectionEventPayload | ListEventPayload | ConfigPanelEventPayload | ElementBrowserEventPayload | CreateLinkInlineDialogEventPayload | HighlightActionsEventPayload | UnsupportedContentPayload | ExtensionEventPayload | TransactionEventPayload | TypeAheadPayload | UnlinkToolbarAEP | EditLinkToolbarAEP | PreviewItemClickedAEP | OpenLinkToolbarAEP | OpenSettingsToolbarAEP | CustomPanelEventPayload | FeatureExposureAEP | NewCollabSyncUpErrorAEP | UnsupportedContentTooltipPayload | ReferentialityEventPayload | LoomEventPayload | MBEEventPayload | HighlightEventPayload | DatasourceClickedPayload | ElementEventPayload | VisitedLinkAEP | ViewEventPayload | MediaUploadEventPayload | MentionEventPayload | EngagementPlatformEventPayload | NestedTableActionsEventPayload | ContainerNodeActionsEventPayload | AICommandPaletteEventPayload | AIDefinitionsEventPayload | AIEventPayload | AIStreamingEventPayload | AIProactiveEventPayload | AiAutocompleteEventPayload | AiSuggestionsEventPayload | ContextualTypeaheadEventPayload | AIQuickPromptEventPayload | AIUnifiedEventPayload | BreakoutEventPayload | BlockMenuEventPayload | ActiveSessionEventPayload | AIInlineSuggestionPayload | SelectionExtensionEventPayload | TelepointerClickPayload | SelectionToolbarEventPayload | ExperienceEventPayload | AlignmentEventPayload | UndoRedoAEP | OfflineEditingEventPayload | NcsSessionStepEventAEP | AgentEditShimmerNotShownAEP | FloatingToolbarOverflowEventPayload | SyncBlockEventPayload | FloatingToolbarEventPayload;
+export type AnalyticsEventPayload<T = void> = AvatarEventPayload | GeneralEventPayload<T> | FormatEventPayload | SubstituteEventPayload | InsertEventPayload | NodeEventPayload | MoveContentEventPayload | MediaEventPayload | TableEventPayload | PasteEventPayload | PasteActionsMenuEventPayload | QuickInsertInformationEventPayload | CutCopyEventPayload | ErrorEventPayload | TextColorEventPayload | FindReplaceEventPayload | DateEventPayload | SelectionEventPayload | ListEventPayload | ConfigPanelEventPayload | ElementBrowserEventPayload | CreateLinkInlineDialogEventPayload | HighlightActionsEventPayload | UnsupportedContentPayload | ExtensionEventPayload | TransactionEventPayload | TypeAheadPayload | UnlinkToolbarAEP | EditLinkToolbarAEP | PreviewItemClickedAEP | OpenLinkToolbarAEP | OpenSettingsToolbarAEP | CustomPanelEventPayload | FeatureExposureAEP | NewCollabSyncUpErrorAEP | UnsupportedContentTooltipPayload | ReferentialityEventPayload | LoomEventPayload | MBEEventPayload | HighlightEventPayload | DatasourceClickedPayload | ElementEventPayload | VisitedLinkAEP | ViewEventPayload | MediaUploadEventPayload | MentionEventPayload | EngagementPlatformEventPayload | NestedTableActionsEventPayload | ContainerNodeActionsEventPayload | AICommandPaletteEventPayload | AIDefinitionsEventPayload | AIEventPayload | AIStreamingEventPayload | AIProactiveEventPayload | AiAutocompleteEventPayload | AiSuggestionsEventPayload | ContextualTypeaheadEventPayload | AIQuickPromptEventPayload | AIUnifiedEventPayload | BreakoutEventPayload | BlockMenuEventPayload | ActiveSessionEventPayload | AIInlineSuggestionPayload | SelectionExtensionEventPayload | TelepointerClickPayload | SelectionToolbarEventPayload | ExperienceEventPayload | AlignmentEventPayload | UndoRedoAEP | OfflineEditingEventPayload | AgentEditShimmerNotShownAEP | FloatingToolbarOverflowEventPayload | SyncBlockEventPayload | FloatingToolbarEventPayload;
 type CustomPanelEventPayload = TrackAEP<ACTION.CHANGED_BACKGROUND_COLOR | ACTION.CHANGED_ICON | ACTION.REMOVE_ICON, ACTION_SUBJECT.PANEL, ACTION_SUBJECT_ID.PANEL, {
     newColor: string;
     previousColor: string;

package/dist/types/analytics/types/general-events.d.ts

@@ -249,7 +249,7 @@ type IndentationMarksTransformedAEP = OperationalAEP<ACTION.INDENTATION_MARKS_TR
 type NodesMissingContentTransformedAEP = OperationalAEP<ACTION.NODES_MISSING_CONTENT_TRANSFORMED, ACTION_SUBJECT.EDITOR, undefined, undefined>;
 type SingleColumLayoutDetectedAEP = OperationalAEP<ACTION.SINGLE_COL_LAYOUT_DETECTED, ACTION_SUBJECT.EDITOR, undefined, undefined>;
 type InvalidMediaContentTransformedAEP = OperationalAEP<ACTION.INVALID_MEDIA_CONTENT_TRANSFORMED, ACTION_SUBJECT.EDITOR, undefined, undefined>;
-type CollabStepsTrackerPayloadAEP = OperationalAEP<ACTION.STEPS_TRACKED | ACTION.STEPS_FILTERED, ACTION_SUBJECT.COLLAB, undefined, {
+type CollabStepsTrackerPayloadAEP = OperationalAEP<ACTION.STEPS_FILTERED, ACTION_SUBJECT.COLLAB, undefined, {
     steps: unknown[];
 }>;
 type CollabOrganicChangesTrackerPayloadAEP = OperationalAEP<ACTION.ORGANIC_CHANGES_TRACKED, ACTION_SUBJECT.COLLAB, undefined, {

package/dist/types/collab/defer-collab-send.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Neutral transaction metadata used by streaming producers to tell the collab layer not to flush
+ * the unconfirmed queue for this transaction.
+ *
+ * The transaction is still applied to the local document immediately; only the network send is
+ * held back. The steps stay in the collab plugin's unconfirmed queue, which is where sending is
+ * deferred from — `sendableSteps` returns the whole queue, so the next unheld transaction sends
+ * everything that accumulated.
+ *
+ * Holding the send is what gives `collapseStreamingSteps` a window to work in: `send()` stamps
+ * `mergeIsLocked` on every origin it flushes, and locked steps can no longer be composed.
+ *
+ * Producers must bound how long they hold. Held steps are content the collab service has not seen,
+ * so they are lost if the tab closes, and a peer editing the same region while steps are held will
+ * rebase against a document that is missing them.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(DEFER_COLLAB_SEND, true);
+ * ```
+ */
+export declare const DEFER_COLLAB_SEND = "deferCollabSend";

package/dist/types/collab/streaming-step-collapse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Neutral transaction metadata used by streaming producers (for example editor-plugin-ai's
+ * in-editor direct streaming) to tell the collab layer that this transaction's steps are an
+ * intermediate frame of a single logical edit.
+ *
+ * Streaming producers re-render the whole in-progress region on every chunk, which means each
+ * frame is a full replace of the region the previous frame inserted. Every frame is applied to the
+ * local document immediately (so the user sees the content stream in), but only the *composition*
+ * of the frames needs to reach the collab service.
+ *
+ * Stamping a transaction with this meta does NOT stop its steps from being sent — it only makes
+ * them eligible to be composed with adjacent frames while they are still unconfirmed. See
+ * `collapseStreamingSteps` in `@atlaskit/editor-plugin-collab-edit`.
+ *
+ * @example
+ * ```ts
+ * tr.setMeta(STREAMING_COLLAPSIBLE_STEPS, true);
+ * ```
+ */
+export declare const STREAMING_COLLAPSIBLE_STEPS = "streamingCollapsibleSteps";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "126.0.0",
+	"version": "126.1.0",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -85,8 +85,8 @@
 		"@atlaskit/task-decision": "^21.11.0",
 		"@atlaskit/teams-app-config": "^3.1.0",
 		"@atlaskit/textfield": "^10.2.0",
-		"@atlaskit/tmp-editor-statsig": "^209.0.0",
-		"@atlaskit/tokens": "^20.0.0",
+		"@atlaskit/tmp-editor-statsig": "^210.0.0",
+		"@atlaskit/tokens": "^20.1.0",
 		"@atlaskit/tooltip": "^24.3.0",
 		"@atlaskit/width-detector": "^7.2.0",
 		"@babel/runtime": "^7.0.0",

package/analytics/types/ncs-session-step-events/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@atlaskit/editor-common/analytics/types/ncs-session-step-events",
-  "main": "../../../dist/cjs/analytics/types/ncs-session-step-events.js",
-  "module": "../../../dist/esm/analytics/types/ncs-session-step-events.js",
-  "module:es2019": "../../../dist/es2019/analytics/types/ncs-session-step-events.js",
-  "sideEffects": [
-    "**/*.compiled.css"
-  ],
-  "types": "../../../dist/types/analytics/types/ncs-session-step-events.d.ts"
-}

package/dist/cjs/analytics/types/ncs-session-step-events.js

@@ -1,5 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});

package/dist/cjs/ncs-step-metrics/index.js

@@ -1,15 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.NCS_STORAGE = void 0;
-// Disable no-re-export rule for entry point files
-/* eslint-disable @atlaskit/editor/no-re-export */
-var NCS_STORAGE = exports.NCS_STORAGE = /*#__PURE__*/function (NCS_STORAGE) {
-  // remove step metrics keys when cleaning up platform_editor_remove_collab_step_metrics
-  NCS_STORAGE["NCS_STORAGE_CLIENT_KEY"] = "ncs-session-step-metrics-storage";
-  NCS_STORAGE["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  NCS_STORAGE["NCS_ACTIVE_SESSIONS"] = "ncsActiveSessions";
-  return NCS_STORAGE;
-}({});

package/dist/es2019/analytics/types/ncs-session-step-events.js

@@ -1 +0,0 @@
-export {};

package/dist/es2019/ncs-step-metrics/index.js

@@ -1,10 +0,0 @@
-// Disable no-re-export rule for entry point files
-/* eslint-disable @atlaskit/editor/no-re-export */
-
-export let NCS_STORAGE = /*#__PURE__*/function (NCS_STORAGE) {
-  // remove step metrics keys when cleaning up platform_editor_remove_collab_step_metrics
-  NCS_STORAGE["NCS_STORAGE_CLIENT_KEY"] = "ncs-session-step-metrics-storage";
-  NCS_STORAGE["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  NCS_STORAGE["NCS_ACTIVE_SESSIONS"] = "ncsActiveSessions";
-  return NCS_STORAGE;
-}({});

package/dist/esm/analytics/types/ncs-session-step-events.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/ncs-step-metrics/index.js

@@ -1,10 +0,0 @@
-// Disable no-re-export rule for entry point files
-/* eslint-disable @atlaskit/editor/no-re-export */
-
-export var NCS_STORAGE = /*#__PURE__*/function (NCS_STORAGE) {
-  // remove step metrics keys when cleaning up platform_editor_remove_collab_step_metrics
-  NCS_STORAGE["NCS_STORAGE_CLIENT_KEY"] = "ncs-session-step-metrics-storage";
-  NCS_STORAGE["NCS_SESSION_STEP_METRICS"] = "ncsSessionStepMetrics";
-  NCS_STORAGE["NCS_ACTIVE_SESSIONS"] = "ncsActiveSessions";
-  return NCS_STORAGE;
-}({});

package/dist/types/analytics/types/ncs-session-step-events.d.ts

@@ -1,11 +0,0 @@
-import type { ACTION, ACTION_SUBJECT } from './enums';
-import type { OperationalAEP } from './utils';
-export type NcsSessionStepMetrics = {
-    maxStepSize: number;
-    ncsSessionId?: string;
-    numberOfSteps: number;
-    p90StepSize?: number;
-    stepSizeSumForP90?: number[];
-    totalStepSize: number;
-};
-export type NcsSessionStepEventAEP = OperationalAEP<ACTION.NCS_SESSION_STEP_METRICS, ACTION_SUBJECT.COLLAB, undefined, NcsSessionStepMetrics>;

package/dist/types/ncs-step-metrics/index.d.ts

@@ -1,5 +0,0 @@
-export declare enum NCS_STORAGE {
-    NCS_STORAGE_CLIENT_KEY = "ncs-session-step-metrics-storage",
-    NCS_SESSION_STEP_METRICS = "ncsSessionStepMetrics",
-    NCS_ACTIVE_SESSIONS = "ncsActiveSessions"
-}

package/ncs-step-metrics/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@atlaskit/editor-common/ncs-step-metrics",
-  "main": "../dist/cjs/ncs-step-metrics/index.js",
-  "module": "../dist/esm/ncs-step-metrics/index.js",
-  "module:es2019": "../dist/es2019/ncs-step-metrics/index.js",
-  "sideEffects": [
-    "**/*.compiled.css"
-  ],
-  "types": "../dist/types/ncs-step-metrics/index.d.ts"
-}