@atlaskit/editor-plugin-collab-edit 17.0.3 → 17.0.5

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @atlaskit/editor-plugin-collab-edit
 
+## 17.0.5
+
+### Patch Changes
+
+- [`3059547e2a266`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/3059547e2a266) -
+  [ux] Extract the configurable post-apply AI highlight and telepointer into a shared plugin and
+  trigger it for collab-edit backend updates behind the
+  `platform_editor_ai_unified_post_apply_chrome` experiment. Connected top-level blocks share one
+  telepointer, separated groups receive their own, and consumers can supply an optional agent avatar
+  identity. Producers resolve dynamic configuration and presentation before sending chrome metadata,
+  and each Rovo frontend update starts with a fresh Post Stream Review range set.
+- Updated dependencies
+
+## 17.0.4
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 17.0.3
 
 ### Patch Changes

package/dist/cjs/pm-plugins/actions.js

@@ -1,15 +1,19 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.registerAllCustomSteps = exports.handleTelePointer = exports.handlePresence = exports.handleInit = exports.handleConnection = exports.getSendableSelection = exports.applyRemoteSteps = exports.applyRemoteData = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var allAdfSchemaSteps = _interopRequireWildcard(require("@atlaskit/adf-schema/steps"));
 var allAtlaskitCustomSteps = _interopRequireWildcard(require("@atlaskit/custom-steps"));
+var _collabAgentEditChrome = require("@atlaskit/editor-common/collab-agent-edit-chrome");
 var _collabAgentRemoteEditReview = require("@atlaskit/editor-common/collab-agent-remote-edit-review");
 var _state = require("@atlaskit/editor-prosemirror/state");
 var _transformOverride = require("@atlaskit/editor-prosemirror/transform-override");
+var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-experiment-enabled");
 var _fg = require("@atlaskit/platform-feature-flags/fg");
 var _prosemirrorCollab = require("@atlaskit/prosemirror-collab");
 var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
@@ -21,12 +25,11 @@ var _agentEditRequester = require("./main/agent-edit-requester");
 var _agentShimmerRanges = require("./main/agent-shimmer-ranges");
 var _utils = require("./utils");
 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); }
-// Ignored via go/ees005
+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; } // Ignored via go/ees005
 // eslint-disable-next-line import/no-namespace
-
 // Ignored via go/ees005
 // eslint-disable-next-line import/no-namespace
-
 /*
  * This is a non-op function to force ProseMirror to load and register all custom steps in the same bundle
  */
@@ -97,7 +100,24 @@ var applyRemoteSteps = exports.applyRemoteSteps = function applyRemoteSteps(json
     var shimmerDurationMs = 0;
     var highlightDurationMs = 0;
     var agentShimmers = [];
-    if ((0, _expValEquals.expValEquals)('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    var isUnifiedPostApplyChromeEnabled = (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_ai_unified_post_apply_chrome');
+    if (isUnifiedPostApplyChromeEnabled && (0, _isExperimentEnabled.isExperimentEnabled)('platform_editor_agent_be_streaming')) {
+      var ranges = (0, _agentShimmerRanges.getAgentEditChromeRanges)(json, steps, tr, view, function (reason, agentType, error) {
+        return editorAnalyticsApi === null || editorAnalyticsApi === void 0 ? void 0 : editorAnalyticsApi.attachAnalyticsEvent((0, _analytics.getAgentEditShimmerNotShownPayload)(reason, agentType, error))(tr);
+      });
+      var requester = (0, _agentEditRequester.getAgentEditRequester)(json, view);
+      if (ranges.length && requester) {
+        // Collab supplies a machine agent type, not a display name; preserve the legacy
+        // uppercase telepointer label.
+        var telepointerLabel = requester.agentType.trim().toUpperCase();
+        tr.setMeta(_collabAgentEditChrome.AGENT_EDIT_CHROME_DATA, _objectSpread(_objectSpread(_objectSpread({}, (0, _collabAgentEditChrome.getAgentEditChromeDynamicConfig)()), telepointerLabel ? {
+          telepointerLabel: telepointerLabel
+        } : {}), {}, {
+          ranges: ranges
+        }));
+      }
+    }
+    if (!isUnifiedPostApplyChromeEnabled && (0, _expValEquals.expValEquals)('platform_editor_agent_be_streaming', 'isEnabled', true)) {
       // The skeleton and purple-highlight phases toggle independently. `shimmerDurationMs` is the
       // skeleton lifetime; `0` skips the skeleton (an edit can still get the purple highlight).
       shimmerDurationMs = (0, _expVal.expVal)('platform_editor_agent_be_streaming', 'shimmerDurationMs', _agentShimmerDecorations.AGENT_SHIMMER_DEFAULT_DURATION_MS);

package/dist/cjs/pm-plugins/main/agent-shimmer-ranges.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isPositionNeutralStep = exports.getMarkStepRange = exports.getAgentShimmerRanges = void 0;
+exports.isPositionNeutralStep = exports.getMarkStepRange = exports.getAgentShimmerRanges = exports.getAgentEditChromeRanges = void 0;
 var _collabAgentReviewSliceCompare = require("@atlaskit/editor-common/collab-agent-review-slice-compare");
 var _monitoring = require("@atlaskit/editor-common/monitoring");
 var _transform = require("@atlaskit/editor-prosemirror/transform");
@@ -80,11 +80,8 @@ var topLevelBlockContentEnd = function topLevelBlockContentEnd(doc, pos) {
  * rebased local step changed sizes (a rare, safe degrade). Any unexpected error also degrades to no
  * shimmer, so this never throws into the shared remote-step handler.
  */
-var getAgentShimmerRanges = exports.getAgentShimmerRanges = function getAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
+var deriveAgentShimmerRanges = function deriveAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
   var _json$find;
-  if (!(0, _expValEquals.expValEquals)('platform_editor_agent_be_streaming', 'isEnabled', true)) {
-    return [];
-  }
   // The two phases toggle independently: `shimmerDurationMs` sizes the skeleton, `highlightDurationMs`
   // sizes the purple highlight, and `0` on either skips just that phase. Nothing to reveal only when
   // both are off.
@@ -251,4 +248,28 @@ var getAgentShimmerRanges = exports.getAgentShimmerRanges = function getAgentShi
     onNotShown === null || onNotShown === void 0 || onNotShown('captureThrew', agentType, err);
     return [];
   }
+};
+var getAgentShimmerRanges = exports.getAgentShimmerRanges = function getAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
+  if (!(0, _expValEquals.expValEquals)('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    return [];
+  }
+  return deriveAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown);
+};
+
+/**
+ * Produces only the neutral changed ranges needed by the shared AI chrome.
+ * The caller supplies lifetime configuration and any presentation override separately,
+ * together with these ranges, in `AgentEditChromeData`.
+ */
+var getAgentEditChromeRanges = exports.getAgentEditChromeRanges = function getAgentEditChromeRanges(json, steps, tr, view, onNotShown) {
+  // Reuse legacy range derivation with skeleton and telepointer output disabled. A non-zero
+  // highlight duration keeps capture enabled; the returned legacy phase and duration are discarded.
+  return deriveAgentShimmerRanges(json, steps, tr, view, 0, 1, false, onNotShown).map(function (_ref) {
+    var from = _ref.from,
+      to = _ref.to;
+    return {
+      from: from,
+      to: to
+    };
+  });
 };

package/dist/es2019/pm-plugins/actions.js

@@ -4,9 +4,11 @@ import * as allAdfSchemaSteps from '@atlaskit/adf-schema/steps';
 // Ignored via go/ees005
 // eslint-disable-next-line import/no-namespace
 import * as allAtlaskitCustomSteps from '@atlaskit/custom-steps';
+import { AGENT_EDIT_CHROME_DATA, getAgentEditChromeDynamicConfig } from '@atlaskit/editor-common/collab-agent-edit-chrome';
 import { AGENT_REMOTE_EDIT_REVIEW_DATA } from '@atlaskit/editor-common/collab-agent-remote-edit-review';
 import { AllSelection, NodeSelection } from '@atlaskit/editor-prosemirror/state';
 import { Step } from '@atlaskit/editor-prosemirror/transform-override';
+import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-experiment-enabled';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { receiveTransaction } from '@atlaskit/prosemirror-collab';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
@@ -15,7 +17,7 @@ import { getAgentEditShimmerNotShownPayload } from './analytics';
 import { getAgentEditSegments } from './main/agent-review-segments';
 import { ADD_AGENT_SHIMMER_META, AGENT_EDIT_HIGHLIGHT_DEFAULT_DURATION_MS, AGENT_SHIMMER_DEFAULT_DURATION_MS, HIGHLIGHT_AGENT_SHIMMER_META, REMOVE_AGENT_SHIMMER_META } from './main/agent-shimmer-decorations';
 import { getAgentEditRequester } from './main/agent-edit-requester';
-import { getAgentShimmerRanges } from './main/agent-shimmer-ranges';
+import { getAgentEditChromeRanges, getAgentShimmerRanges } from './main/agent-shimmer-ranges';
 import { replaceDocument } from './utils';
 
 /*
@@ -101,7 +103,24 @@ export const applyRemoteSteps = (json, view, userIds, options, editorAnalyticsAp
     let shimmerDurationMs = 0;
     let highlightDurationMs = 0;
     let agentShimmers = [];
-    if (expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    const isUnifiedPostApplyChromeEnabled = isExperimentEnabled('platform_editor_ai_unified_post_apply_chrome');
+    if (isUnifiedPostApplyChromeEnabled && isExperimentEnabled('platform_editor_agent_be_streaming')) {
+      const ranges = getAgentEditChromeRanges(json, steps, tr, view, (reason, agentType, error) => editorAnalyticsApi === null || editorAnalyticsApi === void 0 ? void 0 : editorAnalyticsApi.attachAnalyticsEvent(getAgentEditShimmerNotShownPayload(reason, agentType, error))(tr));
+      const requester = getAgentEditRequester(json, view);
+      if (ranges.length && requester) {
+        // Collab supplies a machine agent type, not a display name; preserve the legacy
+        // uppercase telepointer label.
+        const telepointerLabel = requester.agentType.trim().toUpperCase();
+        tr.setMeta(AGENT_EDIT_CHROME_DATA, {
+          ...getAgentEditChromeDynamicConfig(),
+          ...(telepointerLabel ? {
+            telepointerLabel
+          } : {}),
+          ranges
+        });
+      }
+    }
+    if (!isUnifiedPostApplyChromeEnabled && expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
       // The skeleton and purple-highlight phases toggle independently. `shimmerDurationMs` is the
       // skeleton lifetime; `0` skips the skeleton (an edit can still get the purple highlight).
       shimmerDurationMs = expVal('platform_editor_agent_be_streaming', 'shimmerDurationMs', AGENT_SHIMMER_DEFAULT_DURATION_MS);

package/dist/es2019/pm-plugins/main/agent-shimmer-ranges.js

@@ -70,11 +70,8 @@ const topLevelBlockContentEnd = (doc, pos) => {
  * rebased local step changed sizes (a rare, safe degrade). Any unexpected error also degrades to no
  * shimmer, so this never throws into the shared remote-step handler.
  */
-export const getAgentShimmerRanges = (json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) => {
+const deriveAgentShimmerRanges = (json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) => {
   var _json$find;
-  if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
-    return [];
-  }
   // The two phases toggle independently: `shimmerDurationMs` sizes the skeleton, `highlightDurationMs`
   // sizes the purple highlight, and `0` on either skips just that phase. Nothing to reveal only when
   // both are off.
@@ -233,4 +230,27 @@ export const getAgentShimmerRanges = (json, steps, tr, view, shimmerDurationMs,
     onNotShown === null || onNotShown === void 0 ? void 0 : onNotShown('captureThrew', agentType, err);
     return [];
   }
+};
+export const getAgentShimmerRanges = (json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) => {
+  if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    return [];
+  }
+  return deriveAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown);
+};
+
+/**
+ * Produces only the neutral changed ranges needed by the shared AI chrome.
+ * The caller supplies lifetime configuration and any presentation override separately,
+ * together with these ranges, in `AgentEditChromeData`.
+ */
+export const getAgentEditChromeRanges = (json, steps, tr, view, onNotShown) => {
+  // Reuse legacy range derivation with skeleton and telepointer output disabled. A non-zero
+  // highlight duration keeps capture enabled; the returned legacy phase and duration are discarded.
+  return deriveAgentShimmerRanges(json, steps, tr, view, 0, 1, false, onNotShown).map(({
+    from,
+    to
+  }) => ({
+    from,
+    to
+  }));
 };

package/dist/esm/pm-plugins/actions.js

@@ -1,12 +1,17 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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) { _defineProperty(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; }
 // Ignored via go/ees005
 // eslint-disable-next-line import/no-namespace
 import * as allAdfSchemaSteps from '@atlaskit/adf-schema/steps';
 // Ignored via go/ees005
 // eslint-disable-next-line import/no-namespace
 import * as allAtlaskitCustomSteps from '@atlaskit/custom-steps';
+import { AGENT_EDIT_CHROME_DATA, getAgentEditChromeDynamicConfig } from '@atlaskit/editor-common/collab-agent-edit-chrome';
 import { AGENT_REMOTE_EDIT_REVIEW_DATA } from '@atlaskit/editor-common/collab-agent-remote-edit-review';
 import { AllSelection, NodeSelection } from '@atlaskit/editor-prosemirror/state';
 import { Step } from '@atlaskit/editor-prosemirror/transform-override';
+import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-experiment-enabled';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { receiveTransaction } from '@atlaskit/prosemirror-collab';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
@@ -15,7 +20,7 @@ import { getAgentEditShimmerNotShownPayload } from './analytics';
 import { getAgentEditSegments } from './main/agent-review-segments';
 import { ADD_AGENT_SHIMMER_META, AGENT_EDIT_HIGHLIGHT_DEFAULT_DURATION_MS, AGENT_SHIMMER_DEFAULT_DURATION_MS, HIGHLIGHT_AGENT_SHIMMER_META, REMOVE_AGENT_SHIMMER_META } from './main/agent-shimmer-decorations';
 import { getAgentEditRequester } from './main/agent-edit-requester';
-import { getAgentShimmerRanges } from './main/agent-shimmer-ranges';
+import { getAgentEditChromeRanges, getAgentShimmerRanges } from './main/agent-shimmer-ranges';
 import { replaceDocument } from './utils';
 
 /*
@@ -88,7 +93,24 @@ export var applyRemoteSteps = function applyRemoteSteps(json, view, userIds, opt
     var shimmerDurationMs = 0;
     var highlightDurationMs = 0;
     var agentShimmers = [];
-    if (expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    var isUnifiedPostApplyChromeEnabled = isExperimentEnabled('platform_editor_ai_unified_post_apply_chrome');
+    if (isUnifiedPostApplyChromeEnabled && isExperimentEnabled('platform_editor_agent_be_streaming')) {
+      var ranges = getAgentEditChromeRanges(json, steps, tr, view, function (reason, agentType, error) {
+        return editorAnalyticsApi === null || editorAnalyticsApi === void 0 ? void 0 : editorAnalyticsApi.attachAnalyticsEvent(getAgentEditShimmerNotShownPayload(reason, agentType, error))(tr);
+      });
+      var requester = getAgentEditRequester(json, view);
+      if (ranges.length && requester) {
+        // Collab supplies a machine agent type, not a display name; preserve the legacy
+        // uppercase telepointer label.
+        var telepointerLabel = requester.agentType.trim().toUpperCase();
+        tr.setMeta(AGENT_EDIT_CHROME_DATA, _objectSpread(_objectSpread(_objectSpread({}, getAgentEditChromeDynamicConfig()), telepointerLabel ? {
+          telepointerLabel: telepointerLabel
+        } : {}), {}, {
+          ranges: ranges
+        }));
+      }
+    }
+    if (!isUnifiedPostApplyChromeEnabled && expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
       // The skeleton and purple-highlight phases toggle independently. `shimmerDurationMs` is the
       // skeleton lifetime; `0` skips the skeleton (an edit can still get the purple highlight).
       shimmerDurationMs = expVal('platform_editor_agent_be_streaming', 'shimmerDurationMs', AGENT_SHIMMER_DEFAULT_DURATION_MS);

package/dist/esm/pm-plugins/main/agent-shimmer-ranges.js

@@ -74,11 +74,8 @@ var topLevelBlockContentEnd = function topLevelBlockContentEnd(doc, pos) {
  * rebased local step changed sizes (a rare, safe degrade). Any unexpected error also degrades to no
  * shimmer, so this never throws into the shared remote-step handler.
  */
-export var getAgentShimmerRanges = function getAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
+var deriveAgentShimmerRanges = function deriveAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
   var _json$find;
-  if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
-    return [];
-  }
   // The two phases toggle independently: `shimmerDurationMs` sizes the skeleton, `highlightDurationMs`
   // sizes the purple highlight, and `0` on either skips just that phase. Nothing to reveal only when
   // both are off.
@@ -245,4 +242,28 @@ export var getAgentShimmerRanges = function getAgentShimmerRanges(json, steps, t
     onNotShown === null || onNotShown === void 0 || onNotShown('captureThrew', agentType, err);
     return [];
   }
+};
+export var getAgentShimmerRanges = function getAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown) {
+  if (!expValEquals('platform_editor_agent_be_streaming', 'isEnabled', true)) {
+    return [];
+  }
+  return deriveAgentShimmerRanges(json, steps, tr, view, shimmerDurationMs, highlightDurationMs, telepointerEnabled, onNotShown);
+};
+
+/**
+ * Produces only the neutral changed ranges needed by the shared AI chrome.
+ * The caller supplies lifetime configuration and any presentation override separately,
+ * together with these ranges, in `AgentEditChromeData`.
+ */
+export var getAgentEditChromeRanges = function getAgentEditChromeRanges(json, steps, tr, view, onNotShown) {
+  // Reuse legacy range derivation with skeleton and telepointer output disabled. A non-zero
+  // highlight duration keeps capture enabled; the returned legacy phase and duration are discarded.
+  return deriveAgentShimmerRanges(json, steps, tr, view, 0, 1, false, onNotShown).map(function (_ref) {
+    var from = _ref.from,
+      to = _ref.to;
+    return {
+      from: from,
+      to: to
+    };
+  });
 };

package/dist/types/pm-plugins/main/agent-shimmer-ranges.d.ts

@@ -1,4 +1,5 @@
 import type { AgentEditShimmerNotShownReason } from '@atlaskit/editor-common/analytics/types/agent-edit-shimmer-events';
+import type { AgentEditChromeRange } from '@atlaskit/editor-common/collab-agent-edit-chrome';
 import type { Transaction } from '@atlaskit/editor-prosemirror/state';
 import type { Step } from '@atlaskit/editor-prosemirror/transform-override';
 import type { EditorView } from '@atlaskit/editor-prosemirror/view';
@@ -8,20 +9,10 @@ export declare const getMarkStepRange: (step: Step) => {
     from: number;
     to: number;
 } | null;
+export declare const getAgentShimmerRanges: (json: any[], steps: Step[], tr: Transaction, view: EditorView, shimmerDurationMs: number, highlightDurationMs: number, telepointerEnabled: boolean, onNotShown?: (reason: AgentEditShimmerNotShownReason, agentType?: string, error?: Error) => void) => AgentShimmerRange[];
 /**
- * Derive the shimmer ranges for the agent-authored steps in a received batch, in final-doc
- * coordinates. `agentType` present ⇒ agent-authored (per the NCS↔Editor steps contract). Each
- * emitted range is expanded to the whole top-level block(s) the agent touched, which the plugin
- * covers with the skeleton shimmer. Ranges with no new content (pure deletions) are dropped.
- *
- * Steps whose new content is in the same or directly-adjacent top-level block are coalesced into one
- * range, so an edit that arrives as several steps in a region shimmers as a single unit. Edits
- * separated by an untouched block stay independent.
- *
- * Correctness: the range math assumes `tr` is a linear 1:1 apply of `steps`. Under the native collab
- * plugin, `receiveTransaction` rebases incoming steps over unconfirmed local steps when they exist;
- * that only invalidates our positions if a local step shifted positions, so we skip solely when a
- * rebased local step changed sizes (a rare, safe degrade). Any unexpected error also degrades to no
- * shimmer, so this never throws into the shared remote-step handler.
+ * Produces only the neutral changed ranges needed by the shared AI chrome.
+ * The caller supplies lifetime configuration and any presentation override separately,
+ * together with these ranges, in `AgentEditChromeData`.
  */
-export declare const getAgentShimmerRanges: (json: any[], steps: Step[], tr: Transaction, view: EditorView, shimmerDurationMs: number, highlightDurationMs: number, telepointerEnabled: boolean, onNotShown?: (reason: AgentEditShimmerNotShownReason, agentType?: string, error?: Error) => void) => AgentShimmerRange[];
+export declare const getAgentEditChromeRanges: (json: any[], steps: Step[], tr: Transaction, view: EditorView, onNotShown?: (reason: AgentEditShimmerNotShownReason, agentType?: string, error?: Error) => void) => AgentEditChromeRange[];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-collab-edit",
-	"version": "17.0.3",
+	"version": "17.0.5",
 	"description": "Collab Edit plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -21,7 +21,7 @@
 	"dependencies": {
 		"@atlaskit/adf-schema": "^57.2.0",
 		"@atlaskit/custom-steps": "^1.0.0",
-		"@atlaskit/editor-json-transformer": "^9.6.0",
+		"@atlaskit/editor-json-transformer": "^9.7.0",
 		"@atlaskit/editor-plugin-analytics": "^16.0.0",
 		"@atlaskit/editor-plugin-connectivity": "^16.0.0",
 		"@atlaskit/editor-plugin-editor-viewmode": "^18.0.0",
@@ -32,13 +32,13 @@
 		"@atlaskit/platform-feature-experiments": "^0.3.0",
 		"@atlaskit/platform-feature-flags": "^2.1.0",
 		"@atlaskit/prosemirror-collab": "^1.0.0",
-		"@atlaskit/tmp-editor-statsig": "^163.0.0",
+		"@atlaskit/tmp-editor-statsig": "^164.1.0",
 		"@atlaskit/tokens": "^16.8.0",
 		"@babel/runtime": "^7.0.0",
 		"memoize-one": "^6.0.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^120.3.0",
+		"@atlaskit/editor-common": "^120.6.0",
 		"react": "^18.2.0 || ^19.2.0",
 		"react-dom": "^18.2.0 || ^19.2.0"
 	},