@atlaskit/editor-common 116.50.0 → 116.51.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @atlaskit/editor-common
 
+## 116.51.0
+
+### Minor Changes
+
+- [`3e24bdff68508`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/3e24bdff68508) -
+  Add expand-in-panel nesting helpers (isPanelC1SchemaEnabled, isPanelNestingExpandSupported),
+  validation and fallback-transform support for expand children inside panel_c1.
+- [`95e5e100318c4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/95e5e100318c4) -
+  Review moment (Post Stream Review) for BE streaming — record remote agent edits into
+  aiContentPositions and open/append the Review moment (hybrid completion signal + idle debounce).
+  - New `@atlaskit/editor-common/collab/agent-remote-edit-review` subpath export for the neutral
+    agent-edit review contract (AGENT_REMOTE_EDIT_REVIEW_DATA, AgentRemoteEditReviewSegment,
+    AgentRemoteEditReviewData).
+  - Fix chimera delete diffs in agent-review-segments: per-step backward StepMap mapping replaces
+    the previous group-then-invert approach that produced blended original text when multiple
+    discrete operations (delete + insert) interacted in the same region.
+
+- [`2f382e0df09a8`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/2f382e0df09a8) -
+  added actionKind attribute for viewed and discard analytics and fired discard analytics for
+  insights dismiss button
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 116.50.0
 
 ### Minor Changes

package/collab-agent-remote-edit-review/package.json

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

package/dist/cjs/collab/agent-remote-edit-review.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AGENT_REMOTE_EDIT_REVIEW_DATA = void 0;
+/**
+ * [CCI-17994] Meta carried on the transaction that applies a batch of REMOTE
+ * agent-authored steps (BE streaming) in `editor-plugin-collab-edit`'s
+ * `applyRemoteSteps`. It lets `editor-plugin-ai` record the agent's changes for a
+ * Post Stream Review ("Review moment") WITHOUT collab-edit depending on the AI
+ * plugin: the contract is neutral and lives here in `editor-common`, which both
+ * plugins already depend on.
+ *
+ * Stamped whenever a received remote-step batch contains agent-authored steps.
+ * Consumed by `aiSessionContextPlugin.apply()`,
+ * which appends coarse `aiContentPositions` entries — exactly like the in-editor
+ * (FE) streaming path's `AI_FINAL_STREAMING_TRANSFORMATION_DATA`, so the whole
+ * downstream Review moment pipeline (merge → segment → diff → undo/redo → accept)
+ * is reused unchanged.
+ */
+var AGENT_REMOTE_EDIT_REVIEW_DATA = exports.AGENT_REMOTE_EDIT_REVIEW_DATA = 'agentRemoteEditReviewData';

package/dist/cjs/monitoring/error.js

@@ -28,7 +28,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 = "116.49.0";
+var packageVersion = "116.50.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/nesting/isPanelC1SchemaEnabled.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isPanelC1SchemaEnabled = void 0;
+var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
+/*
+ * Returns true when any panel container-variant nesting experiment is enabled, i.e. when the
+ * `panel_c1` node should exist in the schema and be handled by the panel plugin/renderer.
+ *
+ * `panel_c1` is a single shared node that accumulates extra block children over successive
+ * scenarios (table, expand, ...), each gated by its own experiment. Registration, node views,
+ * click handlers and insertion logic are all common to the node, so they should be active when
+ * ANY of those experiments is on.
+ *
+ * ```typescript
+ * if (isPanelC1SchemaEnabled()) {
+ *   // register / handle panel_c1
+ * }
+ * ```
+ */
+var isPanelC1SchemaEnabled = exports.isPanelC1SchemaEnabled = function isPanelC1SchemaEnabled() {
+  return (0, _expValEquals.expValEquals)('platform_editor_nest_table_in_panel', 'isEnabled', true) || (0, _expValEquals.expValEquals)('platform_editor_nest_expand_in_panel', 'isEnabled', true);
+};

package/dist/cjs/nesting/isPanelNestingExpandSupported.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isPanelNestingExpandSupported = void 0;
+var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
+/*
+ * Returns true if the schema supports nesting an expand inside a panel (panel_c1 variant),
+ * AND the `platform_editor_nest_expand_in_panel` experiment is enabled.
+ *
+ * ```typescript
+ * const supportsExpandInPanel = isPanelNestingExpandSupported(state.schema);
+ * ```
+ */
+var isPanelNestingExpandSupported = exports.isPanelNestingExpandSupported = function isPanelNestingExpandSupported(schema) {
+  var _panel_c1$contentMatc;
+  var _schema$nodes = schema.nodes,
+    expand = _schema$nodes.expand,
+    panel_c1 = _schema$nodes.panel_c1;
+  if (!expand || !panel_c1) {
+    return false;
+  }
+
+  // Confirm the PM schema actually allows expand inside panel_c1
+  var panelC1CanContainExpand = ((_panel_c1$contentMatc = panel_c1.contentMatch.matchType(expand)) === null || _panel_c1$contentMatc === void 0 ? void 0 : _panel_c1$contentMatc.validEnd) === true;
+  return panelC1CanContainExpand && (0, _expValEquals.expValEquals)('platform_editor_nest_expand_in_panel', 'isEnabled', true);
+};

package/dist/cjs/nesting/utilities.js

@@ -21,6 +21,18 @@ Object.defineProperty(exports, "isNestedTablesSupported", {
     return _isNestedTablesSupported.isNestedTablesSupported;
   }
 });
+Object.defineProperty(exports, "isPanelC1SchemaEnabled", {
+  enumerable: true,
+  get: function get() {
+    return _isPanelC1SchemaEnabled.isPanelC1SchemaEnabled;
+  }
+});
+Object.defineProperty(exports, "isPanelNestingExpandSupported", {
+  enumerable: true,
+  get: function get() {
+    return _isPanelNestingExpandSupported.isPanelNestingExpandSupported;
+  }
+});
 Object.defineProperty(exports, "isPanelNestingTableSupported", {
   enumerable: true,
   get: function get() {
@@ -37,4 +49,6 @@ var _getParentOfTypeCount = require("./getParentOfTypeCount");
 var _getPositionAfterTopParentNodeOfType = require("./getPositionAfterTopParentNodeOfType");
 var _isSelectionTableNestedInTable = require("./isSelectionTableNestedInTable");
 var _isNestedTablesSupported = require("./isNestedTablesSupported");
-var _isPanelNestingTableSupported = require("./isPanelNestingTableSupported");
+var _isPanelNestingTableSupported = require("./isPanelNestingTableSupported");
+var _isPanelNestingExpandSupported = require("./isPanelNestingExpandSupported");
+var _isPanelC1SchemaEnabled = require("./isPanelC1SchemaEnabled");

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

package/dist/cjs/utils/processRawValue.js

@@ -17,11 +17,18 @@ var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
 var _analytics = require("../analytics");
 var _isNestedTablesSupported = require("../nesting/isNestedTablesSupported");
+var _isPanelNestingExpandSupported = require("../nesting/isPanelNestingExpandSupported");
 var _isPanelNestingTableSupported = require("../nesting/isPanelNestingTableSupported");
 var _privacyFilter = require("./filter/privacy-filter");
 var _trackUnsupportedContent = require("./track-unsupported-content");
 var _validateUsingSpec = require("./validate-using-spec");
 var _processRawFragmentValue = require("./processRawFragmentValue");
+// Gate the generalised (table + expand) panel_c1 fallback behind the expand-in-panel
+// experiment. The in-production table-in-panel path keeps using the deprecated table-only
+// transform until platform_editor_nest_expand_in_panel is rolled out.
+var runPanelC1FallbackTransform = function runPanelC1FallbackTransform(schema, adf) {
+  return (0, _expValEquals.expValEquals)('platform_editor_nest_expand_in_panel', 'isEnabled', true) ? (0, _transforms.panelC1FallbackTransformV2)(schema, adf) : (0, _transforms.panelC1FallbackTransform)(schema, adf);
+};
 var transformNestedTablesWithAnalytics = function transformNestedTablesWithAnalytics(node, dispatchAnalyticsEvent) {
   try {
     var _transformNestedTable = (0, _transforms.transformNestedTablesIncomingDocument)(node),
@@ -100,6 +107,18 @@ var transformContainerNodesWithAnalytics = function transformContainerNodesWithA
     isTransformed: false
   };
 };
+
+/**
+ * Converts a raw ADF value into a ProseMirror `Node` without running full ADF validation.
+ *
+ * Applies the relevant document transforms (nested tables, sync block and panel_c1 fallbacks,
+ * container node nesting) before building the node directly from the resulting JSON.
+ *
+ * @param schema - The ProseMirror schema to build the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or parsing fails.
+ */
 function processRawValueWithoutValidation(schema, value, dispatchAnalyticsEvent) {
   if (!value) {
     return;
@@ -125,7 +144,7 @@ function processRawValueWithoutValidation(schema, value, dispatchAnalyticsEvent)
     transformedAdf = result.transformedAdf;
   }
   if ((0, _platformFeatureFlags.fg)('platform_editor_panel_c1_fallback_transform')) {
-    var panelC1Result = (0, _transforms.panelC1FallbackTransform)(schema, transformedAdf);
+    var panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
     if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
       transformedAdf = panelC1Result.transformedAdf;
     }
@@ -137,6 +156,20 @@ function processRawValueWithoutValidation(schema, value, dispatchAnalyticsEvent)
   return _model.Node.fromJSON(schema, transformedAdf);
 }
 
+/**
+ * Converts a raw ADF value into a validated ProseMirror `Node`.
+ *
+ * Applies document transforms and validates the resulting ADF against the schema, tracking any
+ * unsupported content and optionally sanitizing private content before building the node.
+ *
+ * @param schema - The ProseMirror schema to build and validate the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param providerFactory - Optional provider factory used during validation/sanitization.
+ * @param sanitizePrivateContent - When `true`, private content is stripped from the document.
+ * @param contentTransformer - Optional transformer used to parse string content into ADF.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform/validation analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or processing fails.
+ */
 // eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 function processRawValue(schema, value, providerFactory, sanitizePrivateContent, contentTransformer, dispatchAnalyticsEvent) {
   if (!value) {
@@ -291,7 +324,7 @@ function processRawValue(schema, value, providerFactory, sanitizePrivateContent,
       }
     }
     if ((0, _platformFeatureFlags.fg)('platform_editor_panel_c1_fallback_transform')) {
-      var panelC1Result = (0, _transforms.panelC1FallbackTransform)(schema, transformedAdf);
+      var panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
       if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
         transformedAdf = panelC1Result.transformedAdf;
       }
@@ -301,9 +334,11 @@ function processRawValue(schema, value, providerFactory, sanitizePrivateContent,
     // This matches the renderer's behavior in render-document.ts
     var allowNestedTables = (0, _isNestedTablesSupported.isNestedTablesSupported)(schema);
     var allowTableInPanel = (0, _isPanelNestingTableSupported.isPanelNestingTableSupported)(schema);
-    var validateADFEntityOptions = allowNestedTables || allowTableInPanel ? {
+    var allowExpandInPanel = (0, _isPanelNestingExpandSupported.isPanelNestingExpandSupported)(schema);
+    var validateADFEntityOptions = allowNestedTables || allowTableInPanel || allowExpandInPanel ? {
       allowNestedTables: allowNestedTables || undefined,
-      allowTableInPanel: allowTableInPanel || undefined
+      allowTableInPanel: allowTableInPanel || undefined,
+      allowExpandInPanel: allowExpandInPanel || undefined
     } : undefined;
     var entity = (0, _validateUsingSpec.validateADFEntity)(schema, transformedAdf || node, dispatchAnalyticsEvent, validateADFEntityOptions);
 
@@ -311,7 +346,10 @@ function processRawValue(schema, value, providerFactory, sanitizePrivateContent,
     var _transformNestedTable3 = transformNestedTablesWithAnalytics(entity, dispatchAnalyticsEvent);
     transformedAdf = _transformNestedTable3.transformedAdf;
     entity = transformedAdf;
-    if ((0, _expValEquals.expValEquals)('platform_editor_nest_table_in_panel', 'isEnabled', true)) {
+
+    // The container-node promotion (panel -> panel_c1) is schema-driven and shared across
+    // nesting scenarios, so it runs when any panel container-variant experiment is on.
+    if ((0, _expValEquals.expValEquals)('platform_editor_nest_table_in_panel', 'isEnabled', true) || (0, _expValEquals.expValEquals)('platform_editor_nest_expand_in_panel', 'isEnabled', true)) {
       var _transformContainerNo3 = transformContainerNodesWithAnalytics(entity, schema, dispatchAnalyticsEvent);
       transformedAdf = _transformContainerNo3.transformedAdf;
       entity = transformedAdf;

package/dist/cjs/utils/validate-using-spec.js

@@ -23,7 +23,8 @@ var errorCallbackFor = function errorCallbackFor(marks, validate, dispatchAnalyt
   return function (entity, error, options) {
     return validationErrorHandler(entity, error, _objectSpread(_objectSpread({}, options), {}, {
       allowNestedTables: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowNestedTables,
-      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel
+      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel,
+      allowExpandInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowExpandInPanel
     }), marks, validate, dispatchAnalyticsEvent);
   };
 };
@@ -101,6 +102,17 @@ var validationErrorHandler = exports.validationErrorHandler = function validatio
       return entity;
     }
   }
+
+  // panel_c1 is a ProseMirror-only variant: on save, expand-in-panel documents are stored as
+  // plain ADF `panel` nodes containing an `expand`. The base validator-spec does not permit
+  // `expand` inside `panel` (it's gated behind the experiment), so we suppress the
+  // INVALID_CONTENT error when the experiment is active.
+  if (options.allowExpandInPanel) {
+    var _meta2 = error.meta;
+    if ((_meta2 === null || _meta2 === void 0 ? void 0 : _meta2.parentType) === 'panel' && error.code === 'INVALID_CONTENT' && entity.type === 'expand') {
+      return entity;
+    }
+  }
   if (options.allowUnsupportedBlock) {
     return (0, _wrapWithUnsupported.wrapWithUnsupported)(entity);
   }

package/dist/es2019/collab/agent-remote-edit-review.js

@@ -0,0 +1,16 @@
+/**
+ * [CCI-17994] Meta carried on the transaction that applies a batch of REMOTE
+ * agent-authored steps (BE streaming) in `editor-plugin-collab-edit`'s
+ * `applyRemoteSteps`. It lets `editor-plugin-ai` record the agent's changes for a
+ * Post Stream Review ("Review moment") WITHOUT collab-edit depending on the AI
+ * plugin: the contract is neutral and lives here in `editor-common`, which both
+ * plugins already depend on.
+ *
+ * Stamped whenever a received remote-step batch contains agent-authored steps.
+ * Consumed by `aiSessionContextPlugin.apply()`,
+ * which appends coarse `aiContentPositions` entries — exactly like the in-editor
+ * (FE) streaming path's `AI_FINAL_STREAMING_TRANSFORMATION_DATA`, so the whole
+ * downstream Review moment pipeline (merge → segment → diff → undo/redo → accept)
+ * is reused unchanged.
+ */
+export const AGENT_REMOTE_EDIT_REVIEW_DATA = 'agentRemoteEditReviewData';

package/dist/es2019/monitoring/error.js

@@ -14,7 +14,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 = "116.49.0";
+const packageVersion = "116.50.0";
 const sanitiseSentryEvents = (data, _hint) => {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/es2019/nesting/isPanelC1SchemaEnabled.js

@@ -0,0 +1,18 @@
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+
+/*
+ * Returns true when any panel container-variant nesting experiment is enabled, i.e. when the
+ * `panel_c1` node should exist in the schema and be handled by the panel plugin/renderer.
+ *
+ * `panel_c1` is a single shared node that accumulates extra block children over successive
+ * scenarios (table, expand, ...), each gated by its own experiment. Registration, node views,
+ * click handlers and insertion logic are all common to the node, so they should be active when
+ * ANY of those experiments is on.
+ *
+ * ```typescript
+ * if (isPanelC1SchemaEnabled()) {
+ *   // register / handle panel_c1
+ * }
+ * ```
+ */
+export const isPanelC1SchemaEnabled = () => expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true) || expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true);

package/dist/es2019/nesting/isPanelNestingExpandSupported.js

@@ -0,0 +1,24 @@
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+
+/*
+ * Returns true if the schema supports nesting an expand inside a panel (panel_c1 variant),
+ * AND the `platform_editor_nest_expand_in_panel` experiment is enabled.
+ *
+ * ```typescript
+ * const supportsExpandInPanel = isPanelNestingExpandSupported(state.schema);
+ * ```
+ */
+export const isPanelNestingExpandSupported = schema => {
+  var _panel_c1$contentMatc;
+  const {
+    expand,
+    panel_c1
+  } = schema.nodes;
+  if (!expand || !panel_c1) {
+    return false;
+  }
+
+  // Confirm the PM schema actually allows expand inside panel_c1
+  const panelC1CanContainExpand = ((_panel_c1$contentMatc = panel_c1.contentMatch.matchType(expand)) === null || _panel_c1$contentMatc === void 0 ? void 0 : _panel_c1$contentMatc.validEnd) === true;
+  return panelC1CanContainExpand && expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true);
+};

package/dist/es2019/nesting/utilities.js

@@ -7,4 +7,8 @@ export { isSelectionTableNestedInTable } from './isSelectionTableNestedInTable';
 // eslint-disable-next-line @atlaskit/editor/no-re-export
 export { isNestedTablesSupported } from './isNestedTablesSupported';
 // eslint-disable-next-line @atlaskit/editor/no-re-export
-export { isPanelNestingTableSupported } from './isPanelNestingTableSupported';
+export { isPanelNestingTableSupported } from './isPanelNestingTableSupported';
+// eslint-disable-next-line @atlaskit/editor/no-re-export
+export { isPanelNestingExpandSupported } from './isPanelNestingExpandSupported';
+// eslint-disable-next-line @atlaskit/editor/no-re-export
+export { isPanelC1SchemaEnabled } from './isPanelC1SchemaEnabled';

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';
 import Layer from '../Layer';
 const packageName = "@atlaskit/editor-common";
-const packageVersion = "116.49.0";
+const packageVersion = "116.50.0";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

package/dist/es2019/utils/processRawValue.js

@@ -1,13 +1,19 @@
-import { panelC1FallbackTransform, syncBlockFallbackTransform, transformDedupeMarks, transformIndentationMarks, transformInvalidMediaContent, transformMediaLinkMarks, transformNestedTablesIncomingDocument, transformNodesMissingContent, transformTextLinkCodeMarks, transformMediaSingleWidth, transformContainerNodes } from '@atlaskit/adf-utils/transforms';
+import { panelC1FallbackTransform, panelC1FallbackTransformV2, syncBlockFallbackTransform, transformDedupeMarks, transformIndentationMarks, transformInvalidMediaContent, transformMediaLinkMarks, transformNestedTablesIncomingDocument, transformNodesMissingContent, transformTextLinkCodeMarks, transformMediaSingleWidth, transformContainerNodes } from '@atlaskit/adf-utils/transforms';
 import { Node } from '@atlaskit/editor-prosemirror/model';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { ACTION, ACTION_SUBJECT, EVENT_TYPE } from '../analytics';
 import { isNestedTablesSupported } from '../nesting/isNestedTablesSupported';
+import { isPanelNestingExpandSupported } from '../nesting/isPanelNestingExpandSupported';
 import { isPanelNestingTableSupported } from '../nesting/isPanelNestingTableSupported';
 import { sanitizeNodeForPrivacy } from './filter/privacy-filter';
 import { findAndTrackUnsupportedContentNodes } from './track-unsupported-content';
 import { validateADFEntity } from './validate-using-spec';
+
+// Gate the generalised (table + expand) panel_c1 fallback behind the expand-in-panel
+// experiment. The in-production table-in-panel path keeps using the deprecated table-only
+// transform until platform_editor_nest_expand_in_panel is rolled out.
+const runPanelC1FallbackTransform = (schema, adf) => expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true) ? panelC1FallbackTransformV2(schema, adf) : panelC1FallbackTransform(schema, adf);
 const transformNestedTablesWithAnalytics = (node, dispatchAnalyticsEvent) => {
   try {
     const {
@@ -88,6 +94,18 @@ const transformContainerNodesWithAnalytics = (node, schema, dispatchAnalyticsEve
     isTransformed: false
   };
 };
+
+/**
+ * Converts a raw ADF value into a ProseMirror `Node` without running full ADF validation.
+ *
+ * Applies the relevant document transforms (nested tables, sync block and panel_c1 fallbacks,
+ * container node nesting) before building the node directly from the resulting JSON.
+ *
+ * @param schema - The ProseMirror schema to build the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or parsing fails.
+ */
 export function processRawValueWithoutValidation(schema, value, dispatchAnalyticsEvent) {
   if (!value) {
     return;
@@ -114,7 +132,7 @@ export function processRawValueWithoutValidation(schema, value, dispatchAnalytic
     transformedAdf = result.transformedAdf;
   }
   if (fg('platform_editor_panel_c1_fallback_transform')) {
-    const panelC1Result = panelC1FallbackTransform(schema, transformedAdf);
+    const panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
     if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
       transformedAdf = panelC1Result.transformedAdf;
     }
@@ -127,6 +145,20 @@ export function processRawValueWithoutValidation(schema, value, dispatchAnalytic
   return Node.fromJSON(schema, transformedAdf);
 }
 
+/**
+ * Converts a raw ADF value into a validated ProseMirror `Node`.
+ *
+ * Applies document transforms and validates the resulting ADF against the schema, tracking any
+ * unsupported content and optionally sanitizing private content before building the node.
+ *
+ * @param schema - The ProseMirror schema to build and validate the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param providerFactory - Optional provider factory used during validation/sanitization.
+ * @param sanitizePrivateContent - When `true`, private content is stripped from the document.
+ * @param contentTransformer - Optional transformer used to parse string content into ADF.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform/validation analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or processing fails.
+ */
 // eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 export function processRawValue(schema, value, providerFactory, sanitizePrivateContent, contentTransformer, dispatchAnalyticsEvent) {
   if (!value) {
@@ -286,7 +318,7 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
       }
     }
     if (fg('platform_editor_panel_c1_fallback_transform')) {
-      const panelC1Result = panelC1FallbackTransform(schema, transformedAdf);
+      const panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
       if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
         transformedAdf = panelC1Result.transformedAdf;
       }
@@ -296,9 +328,11 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
     // This matches the renderer's behavior in render-document.ts
     const allowNestedTables = isNestedTablesSupported(schema);
     const allowTableInPanel = isPanelNestingTableSupported(schema);
-    const validateADFEntityOptions = allowNestedTables || allowTableInPanel ? {
+    const allowExpandInPanel = isPanelNestingExpandSupported(schema);
+    const validateADFEntityOptions = allowNestedTables || allowTableInPanel || allowExpandInPanel ? {
       allowNestedTables: allowNestedTables || undefined,
-      allowTableInPanel: allowTableInPanel || undefined
+      allowTableInPanel: allowTableInPanel || undefined,
+      allowExpandInPanel: allowExpandInPanel || undefined
     } : undefined;
     let entity = validateADFEntity(schema, transformedAdf || node, dispatchAnalyticsEvent, validateADFEntityOptions);
 
@@ -307,7 +341,10 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
       transformedAdf
     } = transformNestedTablesWithAnalytics(entity, dispatchAnalyticsEvent));
     entity = transformedAdf;
-    if (expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true)) {
+
+    // The container-node promotion (panel -> panel_c1) is schema-driven and shared across
+    // nesting scenarios, so it runs when any panel container-variant experiment is on.
+    if (expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true) || expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true)) {
       ({
         transformedAdf
       } = transformContainerNodesWithAnalytics(entity, schema, dispatchAnalyticsEvent));

package/dist/es2019/utils/validate-using-spec.js

@@ -8,7 +8,8 @@ const errorCallbackFor = (marks, validate, dispatchAnalyticsEvent, validationOve
     return validationErrorHandler(entity, error, {
       ...options,
       allowNestedTables: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowNestedTables,
-      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel
+      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel,
+      allowExpandInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowExpandInPanel
     }, marks, validate, dispatchAnalyticsEvent);
   };
 };
@@ -86,6 +87,17 @@ export const validationErrorHandler = (entity, error, options, marks, validate,
       return entity;
     }
   }
+
+  // panel_c1 is a ProseMirror-only variant: on save, expand-in-panel documents are stored as
+  // plain ADF `panel` nodes containing an `expand`. The base validator-spec does not permit
+  // `expand` inside `panel` (it's gated behind the experiment), so we suppress the
+  // INVALID_CONTENT error when the experiment is active.
+  if (options.allowExpandInPanel) {
+    const meta = error.meta;
+    if ((meta === null || meta === void 0 ? void 0 : meta.parentType) === 'panel' && error.code === 'INVALID_CONTENT' && entity.type === 'expand') {
+      return entity;
+    }
+  }
   if (options.allowUnsupportedBlock) {
     return wrapWithUnsupported(entity);
   }

package/dist/esm/collab/agent-remote-edit-review.js

@@ -0,0 +1,16 @@
+/**
+ * [CCI-17994] Meta carried on the transaction that applies a batch of REMOTE
+ * agent-authored steps (BE streaming) in `editor-plugin-collab-edit`'s
+ * `applyRemoteSteps`. It lets `editor-plugin-ai` record the agent's changes for a
+ * Post Stream Review ("Review moment") WITHOUT collab-edit depending on the AI
+ * plugin: the contract is neutral and lives here in `editor-common`, which both
+ * plugins already depend on.
+ *
+ * Stamped whenever a received remote-step batch contains agent-authored steps.
+ * Consumed by `aiSessionContextPlugin.apply()`,
+ * which appends coarse `aiContentPositions` entries — exactly like the in-editor
+ * (FE) streaming path's `AI_FINAL_STREAMING_TRANSFORMATION_DATA`, so the whole
+ * downstream Review moment pipeline (merge → segment → diff → undo/redo → accept)
+ * is reused unchanged.
+ */
+export var AGENT_REMOTE_EDIT_REVIEW_DATA = 'agentRemoteEditReviewData';

package/dist/esm/monitoring/error.js

@@ -20,7 +20,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 = "116.49.0";
+var packageVersion = "116.50.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/esm/nesting/isPanelC1SchemaEnabled.js

@@ -0,0 +1,20 @@
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+
+/*
+ * Returns true when any panel container-variant nesting experiment is enabled, i.e. when the
+ * `panel_c1` node should exist in the schema and be handled by the panel plugin/renderer.
+ *
+ * `panel_c1` is a single shared node that accumulates extra block children over successive
+ * scenarios (table, expand, ...), each gated by its own experiment. Registration, node views,
+ * click handlers and insertion logic are all common to the node, so they should be active when
+ * ANY of those experiments is on.
+ *
+ * ```typescript
+ * if (isPanelC1SchemaEnabled()) {
+ *   // register / handle panel_c1
+ * }
+ * ```
+ */
+export var isPanelC1SchemaEnabled = function isPanelC1SchemaEnabled() {
+  return expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true) || expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true);
+};

package/dist/esm/nesting/isPanelNestingExpandSupported.js

@@ -0,0 +1,23 @@
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
+
+/*
+ * Returns true if the schema supports nesting an expand inside a panel (panel_c1 variant),
+ * AND the `platform_editor_nest_expand_in_panel` experiment is enabled.
+ *
+ * ```typescript
+ * const supportsExpandInPanel = isPanelNestingExpandSupported(state.schema);
+ * ```
+ */
+export var isPanelNestingExpandSupported = function isPanelNestingExpandSupported(schema) {
+  var _panel_c1$contentMatc;
+  var _schema$nodes = schema.nodes,
+    expand = _schema$nodes.expand,
+    panel_c1 = _schema$nodes.panel_c1;
+  if (!expand || !panel_c1) {
+    return false;
+  }
+
+  // Confirm the PM schema actually allows expand inside panel_c1
+  var panelC1CanContainExpand = ((_panel_c1$contentMatc = panel_c1.contentMatch.matchType(expand)) === null || _panel_c1$contentMatc === void 0 ? void 0 : _panel_c1$contentMatc.validEnd) === true;
+  return panelC1CanContainExpand && expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true);
+};

package/dist/esm/nesting/utilities.js

@@ -7,4 +7,8 @@ export { isSelectionTableNestedInTable } from './isSelectionTableNestedInTable';
 // eslint-disable-next-line @atlaskit/editor/no-re-export
 export { isNestedTablesSupported } from './isNestedTablesSupported';
 // eslint-disable-next-line @atlaskit/editor/no-re-export
-export { isPanelNestingTableSupported } from './isPanelNestingTableSupported';
+export { isPanelNestingTableSupported } from './isPanelNestingTableSupported';
+// eslint-disable-next-line @atlaskit/editor/no-re-export
+export { isPanelNestingExpandSupported } from './isPanelNestingExpandSupported';
+// eslint-disable-next-line @atlaskit/editor/no-re-export
+export { isPanelC1SchemaEnabled } from './isPanelC1SchemaEnabled';

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';
 import Layer from '../Layer';
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "116.49.0";
+var packageVersion = "116.50.0";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

package/dist/esm/utils/processRawValue.js

@@ -1,13 +1,21 @@
-import { panelC1FallbackTransform, syncBlockFallbackTransform, transformDedupeMarks, transformIndentationMarks, transformInvalidMediaContent, transformMediaLinkMarks, transformNestedTablesIncomingDocument, transformNodesMissingContent, transformTextLinkCodeMarks, transformMediaSingleWidth, transformContainerNodes } from '@atlaskit/adf-utils/transforms';
+import { panelC1FallbackTransform, panelC1FallbackTransformV2, syncBlockFallbackTransform, transformDedupeMarks, transformIndentationMarks, transformInvalidMediaContent, transformMediaLinkMarks, transformNestedTablesIncomingDocument, transformNodesMissingContent, transformTextLinkCodeMarks, transformMediaSingleWidth, transformContainerNodes } from '@atlaskit/adf-utils/transforms';
 import { Node } from '@atlaskit/editor-prosemirror/model';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { ACTION, ACTION_SUBJECT, EVENT_TYPE } from '../analytics';
 import { isNestedTablesSupported } from '../nesting/isNestedTablesSupported';
+import { isPanelNestingExpandSupported } from '../nesting/isPanelNestingExpandSupported';
 import { isPanelNestingTableSupported } from '../nesting/isPanelNestingTableSupported';
 import { sanitizeNodeForPrivacy } from './filter/privacy-filter';
 import { findAndTrackUnsupportedContentNodes } from './track-unsupported-content';
 import { validateADFEntity } from './validate-using-spec';
+
+// Gate the generalised (table + expand) panel_c1 fallback behind the expand-in-panel
+// experiment. The in-production table-in-panel path keeps using the deprecated table-only
+// transform until platform_editor_nest_expand_in_panel is rolled out.
+var runPanelC1FallbackTransform = function runPanelC1FallbackTransform(schema, adf) {
+  return expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true) ? panelC1FallbackTransformV2(schema, adf) : panelC1FallbackTransform(schema, adf);
+};
 var transformNestedTablesWithAnalytics = function transformNestedTablesWithAnalytics(node, dispatchAnalyticsEvent) {
   try {
     var _transformNestedTable = transformNestedTablesIncomingDocument(node),
@@ -86,6 +94,18 @@ var transformContainerNodesWithAnalytics = function transformContainerNodesWithA
     isTransformed: false
   };
 };
+
+/**
+ * Converts a raw ADF value into a ProseMirror `Node` without running full ADF validation.
+ *
+ * Applies the relevant document transforms (nested tables, sync block and panel_c1 fallbacks,
+ * container node nesting) before building the node directly from the resulting JSON.
+ *
+ * @param schema - The ProseMirror schema to build the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or parsing fails.
+ */
 export function processRawValueWithoutValidation(schema, value, dispatchAnalyticsEvent) {
   if (!value) {
     return;
@@ -111,7 +131,7 @@ export function processRawValueWithoutValidation(schema, value, dispatchAnalytic
     transformedAdf = result.transformedAdf;
   }
   if (fg('platform_editor_panel_c1_fallback_transform')) {
-    var panelC1Result = panelC1FallbackTransform(schema, transformedAdf);
+    var panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
     if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
       transformedAdf = panelC1Result.transformedAdf;
     }
@@ -123,6 +143,20 @@ export function processRawValueWithoutValidation(schema, value, dispatchAnalytic
   return Node.fromJSON(schema, transformedAdf);
 }
 
+/**
+ * Converts a raw ADF value into a validated ProseMirror `Node`.
+ *
+ * Applies document transforms and validates the resulting ADF against the schema, tracking any
+ * unsupported content and optionally sanitizing private content before building the node.
+ *
+ * @param schema - The ProseMirror schema to build and validate the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param providerFactory - Optional provider factory used during validation/sanitization.
+ * @param sanitizePrivateContent - When `true`, private content is stripped from the document.
+ * @param contentTransformer - Optional transformer used to parse string content into ADF.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform/validation analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or processing fails.
+ */
 // eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
 export function processRawValue(schema, value, providerFactory, sanitizePrivateContent, contentTransformer, dispatchAnalyticsEvent) {
   if (!value) {
@@ -277,7 +311,7 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
       }
     }
     if (fg('platform_editor_panel_c1_fallback_transform')) {
-      var panelC1Result = panelC1FallbackTransform(schema, transformedAdf);
+      var panelC1Result = runPanelC1FallbackTransform(schema, transformedAdf);
       if (panelC1Result.isTransformed && panelC1Result.transformedAdf) {
         transformedAdf = panelC1Result.transformedAdf;
       }
@@ -287,9 +321,11 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
     // This matches the renderer's behavior in render-document.ts
     var allowNestedTables = isNestedTablesSupported(schema);
     var allowTableInPanel = isPanelNestingTableSupported(schema);
-    var validateADFEntityOptions = allowNestedTables || allowTableInPanel ? {
+    var allowExpandInPanel = isPanelNestingExpandSupported(schema);
+    var validateADFEntityOptions = allowNestedTables || allowTableInPanel || allowExpandInPanel ? {
       allowNestedTables: allowNestedTables || undefined,
-      allowTableInPanel: allowTableInPanel || undefined
+      allowTableInPanel: allowTableInPanel || undefined,
+      allowExpandInPanel: allowExpandInPanel || undefined
     } : undefined;
     var entity = validateADFEntity(schema, transformedAdf || node, dispatchAnalyticsEvent, validateADFEntityOptions);
 
@@ -297,7 +333,10 @@ export function processRawValue(schema, value, providerFactory, sanitizePrivateC
     var _transformNestedTable3 = transformNestedTablesWithAnalytics(entity, dispatchAnalyticsEvent);
     transformedAdf = _transformNestedTable3.transformedAdf;
     entity = transformedAdf;
-    if (expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true)) {
+
+    // The container-node promotion (panel -> panel_c1) is schema-driven and shared across
+    // nesting scenarios, so it runs when any panel container-variant experiment is on.
+    if (expValEquals('platform_editor_nest_table_in_panel', 'isEnabled', true) || expValEquals('platform_editor_nest_expand_in_panel', 'isEnabled', true)) {
       var _transformContainerNo3 = transformContainerNodesWithAnalytics(entity, schema, dispatchAnalyticsEvent);
       transformedAdf = _transformContainerNo3.transformedAdf;
       entity = transformedAdf;

package/dist/esm/utils/validate-using-spec.js

@@ -10,7 +10,8 @@ var errorCallbackFor = function errorCallbackFor(marks, validate, dispatchAnalyt
   return function (entity, error, options) {
     return validationErrorHandler(entity, error, _objectSpread(_objectSpread({}, options), {}, {
       allowNestedTables: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowNestedTables,
-      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel
+      allowTableInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowTableInPanel,
+      allowExpandInPanel: validationOverrides === null || validationOverrides === void 0 ? void 0 : validationOverrides.allowExpandInPanel
     }), marks, validate, dispatchAnalyticsEvent);
   };
 };
@@ -88,6 +89,17 @@ export var validationErrorHandler = function validationErrorHandler(entity, erro
       return entity;
     }
   }
+
+  // panel_c1 is a ProseMirror-only variant: on save, expand-in-panel documents are stored as
+  // plain ADF `panel` nodes containing an `expand`. The base validator-spec does not permit
+  // `expand` inside `panel` (it's gated behind the experiment), so we suppress the
+  // INVALID_CONTENT error when the experiment is active.
+  if (options.allowExpandInPanel) {
+    var _meta2 = error.meta;
+    if ((_meta2 === null || _meta2 === void 0 ? void 0 : _meta2.parentType) === 'panel' && error.code === 'INVALID_CONTENT' && entity.type === 'expand') {
+      return entity;
+    }
+  }
   if (options.allowUnsupportedBlock) {
     return wrapWithUnsupported(entity);
   }

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

@@ -36,6 +36,7 @@ type AcceptSuggestionAEP = TrackAEP<ACTION.ACCEPTED, ACTION_SUBJECT.AI_SUGGESTIO
     suggestionType: string;
 }, undefined>;
 type DiscardSuggestionAEP = TrackAEP<ACTION.DISCARDED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
+    actionKind: string;
     affectedBlocks: number;
     interactionPoint: AiSuggestionInteractionPoint;
     suggestionType: string;
@@ -46,6 +47,7 @@ type DismissSuggestionAEP = TrackAEP<ACTION.DISMISSED, ACTION_SUBJECT.AI_SUGGEST
     suggestionType: string;
 }, undefined>;
 type ViewSuggestionAEP = TrackAEP<ACTION.VIEWED, ACTION_SUBJECT.AI_SUGGESTIONS, undefined, {
+    actionKind: string;
     affectedBlocks: number;
     blockTypes: string[];
     charactersToAdd: number;

package/dist/types/collab/agent-remote-edit-review.d.ts

@@ -0,0 +1,58 @@
+import type { Slice } from '@atlaskit/editor-prosemirror/model';
+/**
+ * [CCI-17994] Meta carried on the transaction that applies a batch of REMOTE
+ * agent-authored steps (BE streaming) in `editor-plugin-collab-edit`'s
+ * `applyRemoteSteps`. It lets `editor-plugin-ai` record the agent's changes for a
+ * Post Stream Review ("Review moment") WITHOUT collab-edit depending on the AI
+ * plugin: the contract is neutral and lives here in `editor-common`, which both
+ * plugins already depend on.
+ *
+ * Stamped whenever a received remote-step batch contains agent-authored steps.
+ * Consumed by `aiSessionContextPlugin.apply()`,
+ * which appends coarse `aiContentPositions` entries — exactly like the in-editor
+ * (FE) streaming path's `AI_FINAL_STREAMING_TRANSFORMATION_DATA`, so the whole
+ * downstream Review moment pipeline (merge → segment → diff → undo/redo → accept)
+ * is reused unchanged.
+ */
+export declare const AGENT_REMOTE_EDIT_REVIEW_DATA = "agentRemoteEditReviewData";
+export interface AgentRemoteEditReviewSegment {
+    /** Live-doc end of the change after the batch applied. A `remove` is zero-width (`endPos === startPos`). */
+    endPos: number;
+    /**
+     * Derived from the slice pair: empty original ⇒ `add`, empty new ⇒ `remove`,
+     * else `update`. Carried so the consumer does not re-derive it.
+     */
+    kind: 'add' | 'remove' | 'update';
+    /** Content now at [startPos, endPos] AFTER the batch (the agent's content; for redo). */
+    newSlice: Slice;
+    /** Content that was at the range BEFORE the batch (for undo / "compare with original"). */
+    originalSlice: Slice;
+    /** Live-doc start of the change after the batch applied. */
+    startPos: number;
+}
+export interface AgentRemoteEditReviewData {
+    /**
+     * AAID the agent acted on behalf of (the requester), read from the agent
+     * steps' `userId`. The AI plugin opens the Review moment only on the client
+     * whose local user matches this — so only the requester reviews. `undefined`
+     * when the batch carried no attributable user.
+     */
+    actorUserId?: string;
+    /**
+     * Identifier of the specific agent that authored the batch, from the agent
+     * steps' `agentId`. Additive on the steps contract, so it may be absent. Not
+     * consumed yet — carried so the contract is explicit, and so a future
+     * multi-agent Review moment can attribute each change to the agent that made
+     * it (`agentType` alone cannot distinguish two agents of the same kind).
+     */
+    agentId?: string;
+    /** The agent kind (e.g. `'mcp'` | `'twg'`), from the agent steps' `agentType`. */
+    agentType?: string;
+    /**
+     * Hybrid end-of-edit signal. When the BE/NCS marks a batch as the terminal one
+     * of an agent edit, the AI plugin opens the Review moment immediately instead of
+     * waiting for the idle debounce. `false`/absent ⇒ rely on the debounce.
+     */
+    complete?: boolean;
+    segments: AgentRemoteEditReviewSegment[];
+}

package/dist/types/nesting/isPanelC1SchemaEnabled.d.ts

@@ -0,0 +1 @@
+export declare const isPanelC1SchemaEnabled: () => boolean;

package/dist/types/nesting/isPanelNestingExpandSupported.d.ts

@@ -0,0 +1,2 @@
+import type { Schema } from '@atlaskit/editor-prosemirror/model';
+export declare const isPanelNestingExpandSupported: (schema: Schema) => boolean;

package/dist/types/nesting/utilities.d.ts

@@ -3,3 +3,5 @@ export { getPositionAfterTopParentNodeOfType } from './getPositionAfterTopParent
 export { isSelectionTableNestedInTable } from './isSelectionTableNestedInTable';
 export { isNestedTablesSupported } from './isNestedTablesSupported';
 export { isPanelNestingTableSupported } from './isPanelNestingTableSupported';
+export { isPanelNestingExpandSupported } from './isPanelNestingExpandSupported';
+export { isPanelC1SchemaEnabled } from './isPanelC1SchemaEnabled';

package/dist/types/utils/processRawValue.d.ts

@@ -3,6 +3,31 @@ import type { Schema } from '@atlaskit/editor-prosemirror/model';
 import type { DispatchAnalyticsEvent } from '../analytics';
 import type { ProviderFactory } from '../provider-factory';
 import type { ReplaceRawValue, Transformer } from '../types';
+/**
+ * Converts a raw ADF value into a ProseMirror `Node` without running full ADF validation.
+ *
+ * Applies the relevant document transforms (nested tables, sync block and panel_c1 fallbacks,
+ * container node nesting) before building the node directly from the resulting JSON.
+ *
+ * @param schema - The ProseMirror schema to build the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or parsing fails.
+ */
 export declare function processRawValueWithoutValidation(schema: Schema, value?: ReplaceRawValue, dispatchAnalyticsEvent?: DispatchAnalyticsEvent): Node | undefined;
+/**
+ * Converts a raw ADF value into a validated ProseMirror `Node`.
+ *
+ * Applies document transforms and validates the resulting ADF against the schema, tracking any
+ * unsupported content and optionally sanitizing private content before building the node.
+ *
+ * @param schema - The ProseMirror schema to build and validate the node against.
+ * @param value - The raw ADF value (string or object) to process.
+ * @param providerFactory - Optional provider factory used during validation/sanitization.
+ * @param sanitizePrivateContent - When `true`, private content is stripped from the document.
+ * @param contentTransformer - Optional transformer used to parse string content into ADF.
+ * @param dispatchAnalyticsEvent - Optional callback used to report transform/validation analytics.
+ * @returns The resulting ProseMirror `Node`, or `undefined` when no value is provided or processing fails.
+ */
 export declare function processRawValue(schema: Schema, value?: ReplaceRawValue, providerFactory?: ProviderFactory, sanitizePrivateContent?: boolean, contentTransformer?: Transformer<string>, dispatchAnalyticsEvent?: DispatchAnalyticsEvent): Node | undefined;
 export { processRawFragmentValue } from './processRawFragmentValue';

package/dist/types/utils/validate-using-spec.d.ts

@@ -13,5 +13,6 @@ export declare const validationErrorHandler: (entity: ADFEntity, error: Validati
 export declare const validateADFEntity: (schema: Schema, node: ADFEntity, dispatchAnalyticsEvent?: DispatchAnalyticsEvent, validationOverrides?: {
     allowNestedTables?: boolean;
     allowTableInPanel?: boolean;
+    allowExpandInPanel?: boolean;
 }) => ADFEntity;
 export { wrapWithUnsupported } from './wrapWithUnsupported';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "116.50.0",
+	"version": "116.51.0",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -29,8 +29,8 @@
 	},
 	"dependencies": {
 		"@atlaskit/activity-provider": "^3.0.0",
-		"@atlaskit/adf-schema": "^56.4.0",
-		"@atlaskit/adf-utils": "^20.4.0",
+		"@atlaskit/adf-schema": "^56.5.0",
+		"@atlaskit/adf-utils": "^20.5.0",
 		"@atlaskit/afm-i18n-platform-editor-editor-common": "2.200.0",
 		"@atlaskit/analytics-listeners": "^11.1.0",
 		"@atlaskit/analytics-namespaced-context": "^8.1.0",
@@ -81,7 +81,7 @@
 		"@atlaskit/task-decision": "^21.8.0",
 		"@atlaskit/teams-app-config": "^2.1.0",
 		"@atlaskit/textfield": "^9.1.0",
-		"@atlaskit/tmp-editor-statsig": "^136.1.0",
+		"@atlaskit/tmp-editor-statsig": "^136.2.0",
 		"@atlaskit/tokens": "^16.3.0",
 		"@atlaskit/tooltip": "^24.0.0",
 		"@atlaskit/width-detector": "^6.2.0",