@atlaskit/editor-plugin-show-diff 17.0.1 → 17.1.0

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

@@ -2,6 +2,7 @@ import { tableMarginTop } from '@atlaskit/editor-common/styles';
 import { getStickyHeaderHeight } from '@atlaskit/editor-common/table/get-sticky-header-height';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { isDiffDecoration, SCROLL_TARGET_MARGIN_CSS_PROPERTY } from './decorations/decorationKeys';
+
 /**
  * Extra space above the scrolled-to element so it does not sit flush under the
  * viewport edge (helps with sticky table headers, toolbars, etc.).

package/dist/esm/pm-plugins/utils/emptyTextBlocks.js

@@ -0,0 +1,60 @@
+/**
+ * The textblock types whose empty form is a blank line the author put there deliberately, and so
+ * worth marking when a change removes it.
+ *
+ * Deliberately not every textblock: an empty `codeBlock` is an empty code block, which renders as a
+ * visible box of its own and needs no stand-in.
+ */
+var BLANK_LINE_NODE_NAMES = new Set(['paragraph', 'heading']);
+
+/**
+ * Structurally empty: no children at all, not merely no measurable content. The two coincide for a
+ * real node, and testing both keeps a node whose children report no size from passing as blank.
+ */
+var isEmptyTextBlock = function isEmptyTextBlock(node) {
+  return BLANK_LINE_NODE_NAMES.has(node.type.name) && node.content.childCount === 0 && node.content.size === 0;
+};
+
+/**
+ * How many empty textblocks a slice holds, or 0 unless that is *all* it holds.
+ *
+ * Counted rather than tested for one, because a run of adjacent blank lines is reported as a single
+ * change covering all of them — the case that made a single-block test miss.
+ */
+export var countEmptyTextBlockOnlySlice = function countEmptyTextBlockOnlySlice(slice) {
+  var _slice$content$childC;
+  var childCount = (_slice$content$childC = slice === null || slice === void 0 ? void 0 : slice.content.childCount) !== null && _slice$content$childC !== void 0 ? _slice$content$childC : 0;
+  if (!slice || childCount === 0) {
+    return 0;
+  }
+  for (var index = 0; index < childCount; index++) {
+    if (!isEmptyTextBlock(slice.content.child(index))) {
+      return 0;
+    }
+  }
+  return childCount;
+};
+
+/**
+ * The content position of every empty textblock lying wholly within `[from, to]`.
+ *
+ * Used to place a marker on each blank line a change removes. Partially covered blocks are skipped:
+ * the change only took part of one, so it still has text of its own, which the inline decoration
+ * already marks.
+ */
+export var emptyTextBlockContentPositions = function emptyTextBlockContentPositions(doc, from, to) {
+  var positions = [];
+  doc.nodesBetween(from, to, function (node, pos) {
+    if (node.isTextblock) {
+      if (isEmptyTextBlock(node) && pos >= from && pos + node.nodeSize <= to) {
+        // +1 steps over the block's own open token, into its (empty) content.
+        positions.push(pos + 1);
+      }
+      // A textblock holds inline content only, so there is nothing below it to visit.
+      return false;
+    }
+    // Keep descending: blank lines nest inside cells, columns and panels.
+    return true;
+  });
+  return positions;
+};

package/dist/esm/showDiffPluginType.js

@@ -1 +1,85 @@
-export {};
+/**
+ * `'standard'` (purple insertions, default) and `'traditional'` (green/red) are the two
+ * plugin-configured schemes. The remaining accent names are the attribution palette used for
+ * per-contributor colouring (`stepsWithAttribution`) — callers of the imperative `showDiff`
+ * command (see `PMDiffParams.colorScheme`) can also pass one of these directly to match a
+ * specific contributor's colour outside of attribution mode, for example matching a Review
+ * moment diff to the streaming highlight of the agent that produced it.
+ */
+
+/**
+ * Attribution for a ProseMirror step.
+ *
+ * `userId` is the primary actor identity. `agentId` distinguishes multiple agents (or an agent
+ * from its user) when they share that user ID, with `agentType` used as a fallback when `agentId`
+ * is empty. `wasOffline` preserves additional provenance without affecting identity.
+ */
+
+/** Keeps a step and its attribution coupled through mapping and filtering. */
+
+/** Branded agent presentations supported by contributor tags. */
+
+export var DIFF_AGENT_BRANDS = new Set(['rovo', 'claude', 'chatgpt']);
+
+/** A complete identity for one of the accounts named by a step attribution. */
+
+/** Agent presentation: branded, identified by profile, or a generic external agent. */
+
+/**
+ * A contributor the plugin has resolved from a step attribution and a supplied profile. Internal:
+ * never re-exported from an entry point and not reachable from any public type. Same for
+ * `DiffContributors`.
+ */
+
+/** Where two contributors share an identity, the last wins. */
+
+/** A contributor stripped of its attributions, as a tag presents it. Internal. */
+
+/**
+ * Everything a contributor tag renders, resolved by the plugin so the tag UI does no lookups.
+ * Declared here rather than beside `extractContributorTags` so the shared state below can name it
+ * without importing back out of this file. Internal, like `TagContributor`.
+ */
+
+/**
+ * Where node/paragraph-level deleted content is rendered relative to the new (replacement)
+ * content in the `smart` diffType:
+ * - `'top'` (default): the deleted content is anchored above the new content.
+ * - `'bottom'`: the deleted content is anchored below the new content.
+ */
+
+/**
+ * Where inline-level (and sentence-level) deleted content is rendered relative to the new
+ * (replacement) content in the `smart` diffType. This is independent of the node/paragraph-level
+ * `deletedDiffPlacement` option:
+ * - `'before'` (default): the deleted content is anchored before the new content.
+ * - `'after'`: the deleted content is anchored after the new content.
+ */
+
+/**
+ * A rendered deleted-content widget: the DOM element show-diff renders for a piece of deleted
+ * content, together with the document position it is anchored at. Deleted content is rendered as
+ * widget decorations rather than document nodes, so this is how consumers recover the element and
+ * its position — via the `getDeletedWidgets` action — without reaching into the plugin's internal
+ * state.
+ */
+
+// Re-export the canonical `SmartDiffThresholds` declaration (single source of truth) so the
+// public plugin types stay in sync with the smart-diff implementation.
+
+/**
+ * How the diff is revealed when it is painted.
+ *
+ * - `phased` — the two-phase choreography used when opening the diff from a clean "new state":
+ *   the outgoing state cross-fades to the incoming one while the agent highlight wipes out to the
+ *   right, then every highlight wipes back in from the left.
+ *
+ * Deliberately separate from {@link DiffType}: that describes how changes are computed and grouped,
+ * this describes how the result is presented over time. Folding one into the other would make every
+ * `DiffType` consumer — version history, track-changes, publish diff — care about presentation.
+ */
+
+/**
+ * Attributed alternative to `PMDiffParams`. When agent colouring is enabled, changes are grouped
+ * by `userId`, with `agentId` used as a tie-breaker.
+ */

package/dist/esm/ui/ContributorTag/contributorAvatarRenderer.js

@@ -7,6 +7,7 @@ import { getContributorTagIcon } from './contributorTagIcons';
 /** Agent kinds with a custom contributor-tag icon. */
 var AGENT_KIND_ICONS = {
   claude: 'claude',
+  chatgpt: 'chatgpt',
   rovo: 'rovoHex'
 };
 
@@ -86,7 +87,7 @@ export var contributorAvatarRenderer = function contributorAvatarRenderer(_ref)
   }
   var image;
   var unbindImageError;
-  var showFallback = function showFallback() {
+  var showContributorIcon = function showContributorIcon() {
     var _unbindImageError, _image, _AGENT_KIND_ICONS, _contributor$agentKin;
     (_unbindImageError = unbindImageError) === null || _unbindImageError === void 0 || _unbindImageError();
     unbindImageError = undefined;
@@ -102,20 +103,27 @@ export var contributorAvatarRenderer = function contributorAvatarRenderer(_ref)
     shape.appendChild(getContributorTagIcon((_AGENT_KIND_ICONS = AGENT_KIND_ICONS[(_contributor$agentKin = contributor.agentKind) !== null && _contributor$agentKin !== void 0 ? _contributor$agentKin : 'external']) !== null && _AGENT_KIND_ICONS !== void 0 ? _AGENT_KIND_ICONS : 'aiAgent', doc));
   };
   if (contributor.avatarUrl) {
-    image = doc.createElement('img');
-    image.alt = '';
-    image.decoding = 'async';
-    image.draggable = false;
-    image.loading = 'lazy';
-    image.setAttribute('style', imageStyle);
-    unbindImageError = bind(image, {
-      type: 'error',
-      listener: showFallback
-    });
-    shape.appendChild(image);
-    image.src = contributor.avatarUrl;
+    var _contributor$agentKin2;
+    // Known brands use their fixed glyph even when the profile also has an avatar URL.
+    var brandedAgentIcon = isAgent ? AGENT_KIND_ICONS[(_contributor$agentKin2 = contributor.agentKind) !== null && _contributor$agentKin2 !== void 0 ? _contributor$agentKin2 : 'external'] : undefined;
+    if (brandedAgentIcon) {
+      showContributorIcon();
+    } else {
+      image = doc.createElement('img');
+      image.alt = '';
+      image.decoding = 'async';
+      image.draggable = false;
+      image.loading = 'lazy';
+      image.setAttribute('style', imageStyle);
+      unbindImageError = bind(image, {
+        type: 'error',
+        listener: showContributorIcon
+      });
+      shape.appendChild(image);
+      image.src = contributor.avatarUrl;
+    }
   } else {
-    showFallback();
+    showContributorIcon();
   }
   var setRingColor = function setRingColor(nextRingColor) {
     if (isAgent) {

package/dist/esm/ui/ContributorTag/contributorTagIcons.js

@@ -27,9 +27,13 @@ var ROVO_HEX_ICON_SVG = "<svg width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" r
 
 /** ClaudeLogo from ai-mate/studio-browse-kit, inset to fit the agent hexagon. */
 var CLAUDE_ICON_SVG = "<svg width=\"12\" height=\"12\" viewBox=\"8 8 32 32\" role=\"presentation\" style=\"display:block\"><path fill=\"#FFFFFF\" d=\"M14.2785 29.274L20.5732 25.7445L20.6785 25.4369L20.5732 25.2669H20.2653L19.2122 25.2021L15.6152 25.105L12.4962 24.9755L9.47443 24.8136L8.71291 24.6517L8 23.7126L8.07291 23.2431L8.71291 22.8141L9.62835 22.895L11.6537 23.0326L14.6916 23.2431L16.8952 23.3726L20.16 23.7126H20.6785L20.7514 23.5022L20.5732 23.3726L20.4354 23.2431L17.2922 21.1141L13.8896 18.8636L12.1073 17.5684L11.1433 16.9127L10.6572 16.2975L10.4466 14.9537L11.3215 13.9904L12.4962 14.0713L12.7959 14.1523L13.9868 15.067L16.5306 17.0342L19.8522 19.4789L20.3382 19.8836L20.5327 19.746L20.557 19.6489L20.3382 19.2846L18.5316 16.0223L16.6035 12.7033L15.7448 11.3271L15.518 10.5014C15.437 10.1614 15.3803 9.87807 15.3803 9.52998L16.3767 8.17809L16.9276 8L18.2562 8.17809L18.8152 8.6638L19.6415 10.55L20.9782 13.5209L23.0522 17.5603L23.6597 18.7584L23.9838 19.8674L24.1053 20.2074H24.3159V20.0132L24.4861 17.7384L24.802 14.9456L25.1099 11.3514L25.2152 10.3395L25.7175 9.12522L26.7139 8.46952L27.4916 8.84189L28.1316 9.75664L28.0425 10.3476L27.6618 12.8166L26.9165 16.6861L26.4304 19.2765H26.7139L27.038 18.9527L28.3504 17.2122L30.5539 14.4599L31.5261 13.3671L32.6603 12.1609L33.3894 11.5861H34.7666L35.7792 13.0918L35.3256 14.6461L33.9079 16.4432L32.7332 17.9651L31.0481 20.2317L29.9949 22.045L30.0922 22.1907L30.3433 22.1665L34.1509 21.3569L36.2086 20.9846L38.6633 20.5636L39.7732 21.0817L39.8947 21.6079L39.4572 22.6845L36.8324 23.3322L33.7539 23.9474L29.1686 25.0321L29.1119 25.0726L29.1767 25.1536L31.2425 25.3478L32.1256 25.3964H34.2886L38.3149 25.6959L39.3681 26.3921L40 27.2421L39.8947 27.8897L38.2744 28.7154L36.0871 28.1973L30.9833 26.9831L29.2334 26.5459H28.9904V26.6916L30.4486 28.1164L33.122 30.5287L36.4678 33.6372L36.638 34.4063L36.2086 35.0134L35.7549 34.9486L32.8142 32.7387L31.68 31.743L29.1119 29.5816H28.9418V29.8082L29.5332 30.6744L32.6603 35.3696L32.8223 36.8105L32.5954 37.28L31.7853 37.5634L30.8942 37.4015L29.0633 34.8353L27.1757 31.9454L25.6527 29.3549L25.4663 29.4602L24.5671 39.1338L24.1458 39.6276L23.1737 40L22.3635 39.3848L21.9342 38.3891L22.3635 36.422L22.882 33.8558L23.3033 31.8158L23.6841 29.2821L23.9109 28.4402L23.8947 28.3835L23.7084 28.4078L21.7965 31.0306L18.8881 34.9567L16.5873 37.4177L16.0365 37.6362L15.0805 37.1424L15.1696 36.2601L15.7043 35.4748L18.8881 31.4273L20.8081 28.9178L22.0476 27.4688L22.0395 27.2583H21.9666L13.5089 32.7468L12.002 32.9411L11.3539 32.3339L11.4349 31.3382L11.7428 31.0144L14.2866 29.2659L14.2785 29.274Z\"/></svg>";
+
+/** ChatGPT Presence avatar from Confluence's `ChatGptPresenceIcon`, at 16px. */
+var CHATGPT_ICON_SVG = '<svg width="16" height="16" viewBox="1 1.5328 16 16" overflow="visible" fill="none" role="presentation" style="display:block"><path d="M7.24707 0.973022C8.33116 0.344106 9.66865 0.342238 10.7539 0.969116L15.751 3.85583C16.8334 4.48117 17.5 5.63699 17.5 6.88708V12.1801C17.5 13.4301 16.8334 14.586 15.751 15.2113L10.751 18.1C9.66769 18.7258 8.33231 18.7258 7.24902 18.1L2.24902 15.2113C1.16658 14.586 0.5 13.4301 0.5 12.1801V6.90271C0.5 5.65489 1.1648 4.50153 2.24414 3.87537L7.24707 0.973022Z" fill="#14120B" stroke="#FFFFFF" stroke-width="1"/><svg x="4" y="4.53355" width="10" height="10" viewBox="10 12.0281 24 24" overflow="visible"><path d="M32.2119 21.2917C32.7552 19.256 32.2283 16.9938 30.6312 15.3967C29.0342 13.7997 26.7722 13.2728 24.7362 13.8161C23.2447 12.3277 21.0224 11.6529 18.8407 12.2376C16.6589 12.8221 15.0717 14.5177 14.5243 16.5524C12.4896 17.0999 10.794 18.6873 10.2094 20.8688C9.62493 23.0506 10.2996 25.2728 11.7881 26.7644C11.2448 28.8002 11.7718 31.0623 13.3688 32.6594C14.9658 34.2564 17.2278 34.7834 19.2638 34.2401C20.7553 35.7284 22.9778 36.4032 25.1593 35.8187C27.3411 35.2342 28.9283 33.5386 29.4757 31.5039C31.5105 30.9564 33.206 29.3691 33.7905 27.1874C34.3751 25.0058 33.7005 22.7834 32.2119 21.2919V21.2917ZM29.6507 16.3775C30.7329 17.4598 31.1792 18.937 30.9897 20.3453L25.9072 17.4108C25.6929 17.2871 25.4289 17.2871 25.2148 17.4108L19.2638 20.8466V18.5936C19.2638 18.4356 19.3485 18.2877 19.4854 18.2087L24.017 15.5924C25.8125 14.5895 28.1246 14.8514 29.6508 16.3775H29.6507ZM22 20.8685L24.7364 22.4483V25.608L22 27.1878L19.2636 25.608V22.4483L22 20.8685ZM15.7028 18.0636C15.732 16.0073 17.1149 14.1359 19.1997 13.5772C20.678 13.1811 22.1806 13.5333 23.3053 14.4014L18.2226 17.3357C18.0084 17.4594 17.8764 17.6881 17.8764 17.9353V24.8069L15.9253 23.6804C15.7885 23.6014 15.7028 23.454 15.7028 23.2959V18.0634V18.0636ZM11.549 21.2278C11.9451 19.7495 13.0014 18.6242 14.3156 18.0843V23.9532C14.3156 24.2004 14.4476 24.4291 14.6618 24.5528L20.6128 27.9886L18.6617 29.1151C18.5249 29.1941 18.3544 29.1946 18.2175 29.1156L13.6859 26.4993C11.9196 25.4459 10.9905 23.3124 11.549 21.2278ZM14.3494 31.6788C13.2671 30.5965 12.8208 29.1193 13.0103 27.7111L18.0928 30.6455C18.3071 30.7692 18.5711 30.7692 18.7852 30.6455L24.7362 27.2098V29.4626C24.7362 29.6207 24.6516 29.7682 24.5146 29.8477L19.983 32.4639C18.1875 33.4667 15.8754 33.2049 14.3492 31.6788H14.3494ZM28.2972 29.9927C28.268 32.049 26.8851 33.9205 24.8003 34.4791C23.322 34.8752 21.8194 34.523 20.6947 33.6549L25.7774 30.7205C25.9917 30.5969 26.1236 30.3682 26.1236 30.1209V23.2494L28.0747 24.3759C28.2115 24.4549 28.2972 24.6023 28.2972 24.7604V29.9929V29.9927ZM32.451 26.8285C32.0549 28.3068 30.9986 29.4321 29.6844 29.972V24.1031C29.6844 23.8559 29.5525 23.6272 29.3382 23.5035L23.3872 20.0678L25.3383 18.9412C25.4751 18.8622 25.6456 18.8617 25.7825 18.9407L30.314 21.5569C32.0804 22.6105 33.0095 24.7439 32.451 26.8285Z" fill="#FFFFFF"/></svg></svg>';
 var markup = {
   aiAgent: AI_AGENT_ICON_SVG,
   aiBot: AI_BOT_ICON_SVG,
+  chatgpt: CHATGPT_ICON_SVG,
   claude: CLAUDE_ICON_SVG,
   person: PERSON_ICON_SVG,
   rovoHex: ROVO_HEX_ICON_SVG

package/dist/types/entry-points/show-diff-plugin-type.d.ts

@@ -1 +1,2 @@
-export type { ColorScheme, DeletedDiffPlacement, DeletedDiffWidget, DiffContributorProfile, DiffParams, DiffStepAttribution, DiffType, PMDiffParams, RevealMode, RevealOptions, ShowDiffParams, ShowDiffPlugin, SmartDiffThresholds, StepWithAttribution, } from '../showDiffPluginType';
+export type { ColorScheme, DeletedDiffPlacement, DeletedDiffWidget, DiffAgentBrand, DiffContributorProfile, DiffParams, DiffStepAttribution, DiffType, PMDiffParams, RevealMode, RevealOptions, ShowDiffParams, ShowDiffPlugin, SmartDiffThresholds, StepWithAttribution, } from '../showDiffPluginType';
+export { DIFF_AGENT_BRANDS } from '../showDiffPluginType';

package/dist/types/pm-plugins/calculateDiff/groupDeletedColumnChanges.d.ts

@@ -0,0 +1,9 @@
+import type { Change } from 'prosemirror-changeset';
+import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+import type { Mapping } from '@atlaskit/editor-prosemirror/transform';
+export type ColumnAwareChange = Change & {
+    deletedColumns?: number[];
+};
+export declare const CELL_CONTENT_OFFSET = 2;
+/** Groups a deleted column's cell changes into one whole-table change. */
+export declare const groupDeletedColumnChanges: (changes: readonly Change[], originalDoc: PMNode, newDoc: PMNode, mapping: Mapping, isInverted: boolean) => ColumnAwareChange[];

package/dist/types/pm-plugins/decorations/colorSchemes/attributions.d.ts

@@ -1,5 +1,5 @@
 import type { Change } from 'prosemirror-changeset';
-import type { DiffContributors, DiffStepAttribution, TagContributor } from '../../../showDiffPluginType';
+import { type DiffContributors, type DiffStepAttribution, type TagContributor } from '../../../showDiffPluginType';
 import { type AdsAccentColor, type ColorScheme } from './types';
 export type DiffAttributionSpanData = DiffStepAttribution & {
     stepIndex: number;
@@ -24,7 +24,7 @@ export declare const isAttributionColoringEnabled: (stepAttributions: Array<Diff
  * a tag only has to name one.
  */
 export declare const isContributorTagsEnabled: (stepAttributions: Array<DiffStepAttribution | undefined> | undefined, contributors: ResolvedDiffContributors | undefined) => boolean;
-export declare const createAttributionColorMap: (stepAttributions: Array<DiffStepAttribution | undefined>) => Map<string, AdsAccentColor>;
+export declare const createAttributionColorMap: (stepAttributions: Array<DiffStepAttribution | undefined>, contributors?: ResolvedDiffContributors) => Map<string, AdsAccentColor>;
 /**
  * The attribution key owning a change. Inline and step changes retain direct attribution spans, so
  * resolve those first. Grouped and smart-classified changes can lose that data; for those, fall

package/dist/types/pm-plugins/decorations/createChangedRowDecorationWidgets.d.ts

@@ -1,4 +1,5 @@
 import type { Change } from 'prosemirror-changeset';
+import type { IntlShape } from 'react-intl';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { Decoration } from '@atlaskit/editor-prosemirror/view';
 import type { DiffType } from '../../showDiffPluginType';
@@ -9,11 +10,12 @@ type SimpleChange = Pick<Change, 'fromA' | 'toA' | 'fromB' | 'deleted'>;
 /**
  * Main function to handle deleted rows - computes diff and creates decorations
  */
-export declare const createChangedRowDecorationWidgets: ({ attributionKey, changes, originalDoc, newDoc, nodeViewSerializer, colorScheme, isActive, isInserted, diffType, showIndicators, showContributorTags, tagMountContext, }: {
+export declare const createChangedRowDecorationWidgets: ({ attributionKey, changes, originalDoc, newDoc, nodeViewSerializer, colorScheme, isActive, isInserted, diffType, intl, showIndicators, showContributorTags, tagMountContext, }: {
     attributionKey?: string;
     changes: SimpleChange[];
     colorScheme?: ColorScheme;
     diffType?: DiffType;
+    intl?: IntlShape;
     isActive?: boolean;
     isInserted?: boolean;
     newDoc: PMNode;

package/dist/types/pm-plugins/decorations/createContributorTagWidget.d.ts

@@ -39,7 +39,11 @@ export declare const unmountContributorTag: (mount: ContributorTagMount | undefi
  * The host for a tag on deleted content, which renders inside its own widget decoration rather than
  * needing one of its own. Unmount with `unmountContributorTag` from that widget's `destroy`.
  */
-export declare const createContributorTagHost: (diffId: string, mountContext?: ContributorTagMountContext) => {
+export declare const createContributorTagHost: ({ anchorName, diffId, mountContext, }: {
+    anchorName?: string;
+    diffId: string;
+    mountContext?: ContributorTagMountContext;
+}) => {
     host: HTMLSpanElement;
     mount: ContributorTagMount | undefined;
 } | undefined;

package/dist/types/pm-plugins/decorations/createNodeChangedDecorationWidget.d.ts

@@ -4,13 +4,13 @@ import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { Decoration } from '@atlaskit/editor-prosemirror/view';
 import type { DiffType, RevealOptions } from '../../showDiffPluginType';
 import type { NodeViewSerializer } from '../NodeViewSerializer';
-import { type ContributorTagMountContext } from './createContributorTagWidget';
 import type { ColorScheme } from './colorSchemes/types';
+import { type ContributorTagMountContext } from './createContributorTagWidget';
 /**
  * This function is used to create a decoration widget to show content
  * that is not in the current document.
  */
-export declare const createNodeChangedDecorationWidget: ({ attributionKey, change, doc, nodeViewSerializer, colorScheme, newDoc, intl, activeIndexPos, isInserted, showContributorTags, showIndicators, placeBelow, diffType, hideAddedDiffsUnderline, reveal, tagMountContext, }: {
+export declare const createNodeChangedDecorationWidget: ({ attributionKey, change, doc, nodeViewSerializer, colorScheme, newDoc, intl, activeIndexPos, isInserted, showContributorTags, showIndicators, placeBelow, diffType, hideAddedDiffsUnderline, reveal, tagMountContext, deletedColumns, }: {
     activeIndexPos?: {
         from: number;
         to: number;
@@ -18,6 +18,7 @@ export declare const createNodeChangedDecorationWidget: ({ attributionKey, chang
     attributionKey?: string;
     change: Pick<Change, 'fromA' | 'toA' | 'fromB' | 'deleted' | 'toB'>;
     colorScheme?: ColorScheme;
+    deletedColumns?: readonly number[];
     diffType?: DiffType;
     doc: PMNode;
     hideAddedDiffsUnderline?: boolean;

package/dist/types/pm-plugins/decorations/utils/createDeletedLineBreakWidget.d.ts

@@ -0,0 +1,50 @@
+import { Decoration } from '@atlaskit/editor-prosemirror/view';
+import type { DiffType, RevealOptions } from '../../../showDiffPluginType';
+import type { ColorScheme } from '../colorSchemes/types';
+/**
+ * U+2936 ARROW POINTING DOWNWARDS THEN CURVING LEFTWARDS — the return-key glyph.
+ *
+ * Exported so tests assert against the glyph actually rendered rather than a copy of it.
+ */
+export declare const RETURN_GLYPH = "\u2936";
+/**
+ * The DOM for a removed blank line: the return glyph, struck through in the deleted colours.
+ *
+ * An empty paragraph or heading is a line the author deliberately added, but it has no content for
+ * the deleted-content widget to serialize, so a deletion of one used to render nothing at all — the
+ * reviewer saw the surrounding text close up with no sign of what was removed. Standing the glyph
+ * in for the absent content keeps the deletion visible without inventing content that was not there.
+ *
+ * `createContentWrapper` supplies the highlight and the strikethrough line, so the glyph is styled
+ * exactly like any other run of deleted inline content, including the active and reveal states.
+ *
+ * Hidden from assistive technology: the glyph is a picture of a key, and read out it is announced as
+ * its Unicode name rather than as a removed line.
+ */
+export declare const createDeletedLineBreakWidget: ({ colorScheme, count, diffType, isActive, reveal, }: {
+    colorScheme?: ColorScheme;
+    /** One glyph per removed blank line, for a run of adjacent ones. */
+    count?: number;
+    diffType?: DiffType;
+    isActive?: boolean;
+    reveal?: RevealOptions;
+}) => HTMLElement;
+/**
+ * The glyph as a widget decoration anchored at `pos`.
+ *
+ * Shared by the two shapes a blank-line removal arrives in. On a forward diff the block is gone from
+ * the new document, so the change lands on the deleted side and the glyph is anchored where the
+ * block used to be. On an inverted diff — what AI suggested edits renders — the block is still in
+ * the displayed document and the change lands on the *inserted* side, so the glyph is anchored
+ * inside the surviving block, on the blank line itself.
+ */
+export declare const createDeletedLineBreakDecoration: ({ attributionKey, colorScheme, count, diffType, isActive, pos, reveal, side, }: {
+    attributionKey?: string;
+    colorScheme?: ColorScheme;
+    count?: number;
+    diffType?: DiffType;
+    isActive?: boolean;
+    pos: number;
+    reveal?: RevealOptions;
+    side?: number;
+}) => Decoration;

package/dist/types/pm-plugins/decorations/utils/getAttrChangeRanges.d.ts

@@ -1,7 +1,7 @@
 import { SetAttrsStep } from '@atlaskit/adf-schema/steps/set-attrs';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
-import type { Step as ProseMirrorStep } from '@atlaskit/editor-prosemirror/transform-override';
 import { AttrStep } from '@atlaskit/editor-prosemirror/transform';
+import type { Step as ProseMirrorStep } from '@atlaskit/editor-prosemirror/transform-override';
 export type InlineAttrChangeNodeName = 'date' | 'emoji' | 'mention' | 'status';
 type AttrChangeStep = AttrStep | SetAttrsStep;
 export type AttrStepContext = {

package/dist/types/pm-plugins/decorations/utils/getMarkChangeRanges.d.ts

@@ -1,5 +1,5 @@
-import type { Step as ProseMirrorStep } from '@atlaskit/editor-prosemirror/transform-override';
 import { type StepMap } from '@atlaskit/editor-prosemirror/transform';
+import type { Step as ProseMirrorStep } from '@atlaskit/editor-prosemirror/transform-override';
 import type { DiffStepAttribution } from '../../../showDiffPluginType';
 type StepRange = {
     attributionKey?: string;

package/dist/types/pm-plugins/decorations/utils/tableDiffMode.d.ts

@@ -0,0 +1,26 @@
+import type { Slice } from '@atlaskit/editor-prosemirror/model';
+export type TableDiffMode = 
+/** Add table headers, or replace whole cells. Draws one content widget per cell. */
+{
+    kind: 'cells';
+}
+/** Delete a row, or replace a whole row. Draws a row copy inside the table. */
+ | {
+    kind: 'rows';
+}
+/** Delete a column, or replace a whole table. Draws a table copy next to the live table. */
+ | {
+    kind: 'wholeTable';
+}
+/** Delete cells with no replacement. The new document has no cell to anchor to, so nothing draws. */
+ | {
+    kind: 'none';
+}
+/** Any change outside a table, such as a paragraph edit. Draws the generic block widget. */
+ | {
+    kind: 'generic';
+};
+export declare const getTableDiffMode: ({ slice, isInserted, }: {
+    isInserted: boolean;
+    slice: Slice;
+}) => TableDiffMode;

package/dist/types/pm-plugins/decorations/utils/wrapBlockNodeView.d.ts

@@ -2,6 +2,10 @@ import type { IntlShape } from 'react-intl';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { DiffType, RevealOptions } from '../../../showDiffPluginType';
 import type { ColorScheme } from '../colorSchemes/types';
+/**
+ * Creates a "Removed" lozenge to be displayed at the top right corner of deleted block nodes
+ */
+export declare const createRemovedLozenge: (intl: IntlShape, isActive?: boolean, colorScheme?: ColorScheme, inCell?: boolean) => HTMLElement;
 /**
  * Handles all block node rendering with appropriate deleted styling.
  * For heading nodes, applies styles directly to preserve natural margins.

package/dist/types/pm-plugins/utils/emptyTextBlocks.d.ts

@@ -0,0 +1,16 @@
+import type { Node as PMNode, Slice } from '@atlaskit/editor-prosemirror/model';
+/**
+ * How many empty textblocks a slice holds, or 0 unless that is *all* it holds.
+ *
+ * Counted rather than tested for one, because a run of adjacent blank lines is reported as a single
+ * change covering all of them — the case that made a single-block test miss.
+ */
+export declare const countEmptyTextBlockOnlySlice: (slice: Slice | undefined) => number;
+/**
+ * The content position of every empty textblock lying wholly within `[from, to]`.
+ *
+ * Used to place a marker on each blank line a change removes. Partially covered blocks are skipped:
+ * the change only took part of one, so it still has text of its own, which the inline decoration
+ * already marks.
+ */
+export declare const emptyTextBlockContentPositions: (doc: PMNode, from: number, to: number) => number[];

package/dist/types/showDiffPluginType.d.ts

@@ -37,16 +37,21 @@ export type StepWithAttribution<TStep> = {
     step: TStep;
     stepAttribution?: DiffStepAttribution;
 };
+/** Branded agent presentations supported by contributor tags. */
+export type DiffAgentBrand = 'rovo' | 'claude' | 'chatgpt';
+export declare const DIFF_AGENT_BRANDS: ReadonlySet<DiffAgentBrand>;
 /** A complete identity for one of the accounts named by a step attribution. */
 export type DiffContributorProfile = {
     /** Matched against the `userId` and `agentId` on step attributions. */
     accountId: string;
+    /** Optional brand for an agent profile, supplied by the host product. */
+    agentBrand?: DiffAgentBrand;
     avatarUrl?: string;
     name: string;
 };
 type DiffContributorKind = 'user' | 'agent';
 /** Agent presentation: branded, identified by profile, or a generic external agent. */
-type DiffAgentKind = 'rovo' | 'claude' | 'identified' | 'external';
+type DiffAgentKind = DiffAgentBrand | 'identified' | 'external';
 /**
  * A contributor the plugin has resolved from a step attribution and a supplied profile. Internal:
  * never re-exported from an entry point and not reachable from any public type. Same for

package/dist/types/ui/ContributorTag/contributorTagIcons.d.ts

@@ -8,5 +8,5 @@
  * The Rovo hex is the `brand` appearance, whose `--rovo-*-color` variables resolve to `initial` in
  * both themes — the fallbacks below are the rendered colours, so no theme observer is needed.
  */
-export type ContributorTagIcon = 'aiAgent' | 'aiBot' | 'claude' | 'person' | 'rovoHex';
+export type ContributorTagIcon = 'aiAgent' | 'aiBot' | 'chatgpt' | 'claude' | 'person' | 'rovoHex';
 export declare const getContributorTagIcon: (icon: ContributorTagIcon, doc: Document) => DocumentFragment;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-show-diff",
-	"version": "17.0.1",
+	"version": "17.1.0",
 	"description": "ShowDiff plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -53,7 +53,7 @@
 		"@atlaskit/button": "^25.3.0",
 		"@atlaskit/css": "^1.1.0",
 		"@atlaskit/dropdown-menu": "^18.3.0",
-		"@atlaskit/editor-core": "^229.0.0",
+		"@atlaskit/editor-core": "^229.1.0",
 		"@atlaskit/editor-json-transformer": "^9.8.0",
 		"@atlaskit/editor-plugins": "^16.1.0",
 		"@atlaskit/form": "^17.2.0",
@@ -64,14 +64,14 @@
 		"@atlassian/confluence-presets": "workspace:^",
 		"@atlassian/content-reconciliation": "^0.1.3506",
 		"@atlassian/editor-ai-injected-editors": "^33.0.0",
-		"@atlassian/editor-plugin-ai": "^73.2.0",
+		"@atlassian/editor-plugin-ai": "^73.3.0",
 		"@atlassian/structured-docs-types": "workspace:^",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0",
 		"react-intl": "^7.0.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^123.0.0",
+		"@atlaskit/editor-common": "^123.2.0",
 		"react": "^18.2.0 || ^19.2.0",
 		"react-dom": "^18.2.0 || ^19.2.0",
 		"react-intl": "^5.25.1 || ^6.0.0 || ^7.0.0"