@atlaskit/editor-plugin-show-diff 13.0.10 → 13.1.0

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

@@ -29,7 +29,6 @@ export declare function buildDeletedInlineStyleUnbounded(colors: DiffColorScheme
 export declare function buildDeletedStyleQuoteNodeWithLozenge(colors: DiffColorScheme): string;
 /** Active state of the deleted lozenge-style quote node — stronger ring. */
 export declare function buildDeletedStyleQuoteNodeWithLozengeActive(colors: DiffColorScheme): string;
-/** Deleted quote node — a 2px left border, or a 1px ring with padding, per `deletedQuoteNodeShape`. */
 export declare function buildDeletedStyleQuoteNode(colors: DiffColorScheme): string;
 /** Quote node outline for deleted content — active state. */
 export declare function buildDeletedStyleQuoteNodeActive(colors: DiffColorScheme): string;
@@ -45,7 +44,7 @@ export declare function buildDeletedBlockOutlineRoundedActive(colors: DiffColorS
 export declare function buildDeletedBlockOutlineNew(colors: DiffColorScheme): string;
 /** Scroll-navigation "new" emphasis: 4px ring — default state (rounded radius). */
 export declare function buildDeletedBlockOutlineRoundedNew(colors: DiffColorScheme): string;
-/** Table row style for deleted rows. See `deletedRowTreatment`. */
+/** Table row style for deleted rows. */
 export declare function buildDeletedRowStyle(colors: DiffColorScheme): string;
 /** Quote node (blockquote) left-border style for inserted content — default state. */
 export declare function buildInsertStyleQuoteNode(colors: DiffColorScheme): string;
@@ -79,19 +78,22 @@ export declare function buildDecorationMarkerVariableNew(colors: DiffColorScheme
 export declare function buildDecorationMarkerVariableActive(colors: DiffColorScheme): string;
 /** Deleted node decoration marker (extension / embedCard / listItem) — default state. */
 export declare function buildDeletedDecorationMarkerVariable(colors: DiffColorScheme): string;
-/** Opacity only, no position or strikethrough. Used by the standard scheme. */
+/** Opacity only, no position or strikethrough. Used by 'static' schemes. */
 export declare function buildDeletedDecorationMarkerVariableSimple(colors: DiffColorScheme): string;
+/**
+ * 'glyphTint' deleted inline style — tints the glyph itself via `color:`. Opacity ramps 0.6
+ * default, 0.83 "new", 1 active.
+ */
 /** Extended deleted inline style — background highlight + border-bottom underline (standard scheme). */
 export declare function buildDeletedInlineContentStyleExtended(colors: DiffColorScheme): string;
-/** Standard deleted inline style — colours the glyph itself, not just the strikethrough. */
 export declare function buildDeletedInlineStyleStandard(colors: DiffColorScheme, state: 'default' | 'new' | 'active'): string;
 /** Deleted node decoration marker — "new" state. */
 export declare function buildDeletedDecorationMarkerVariableNew(colors: DiffColorScheme): string;
 /** Deleted node decoration marker — active state. */
 export declare function buildDeletedDecorationMarkerVariableActive(colors: DiffColorScheme): string;
-/** Cell overlay for added table cells — default state. Stacking order varies by scheme. */
+/** Cell overlay for added table cells — default state (zIndex 1). */
 export declare function buildAddedCellOverlayStyle(colors: DiffColorScheme): string;
-/** Added cell overlay — rounded variant. See `roundedAddedCellOverlayInheritsBorder`. */
+/** Cell overlay for added table cells — rounded variant (zIndex 2, inherits border/radius). */
 export declare function buildAddedCellOverlayRoundedStyle(colors: DiffColorScheme): string;
 /** Cell overlay for added table cells — "new" scroll-nav state. */
 export declare function buildAddedCellOverlayStyleNew(colors: DiffColorScheme): string;
@@ -99,3 +101,73 @@ export declare function buildAddedCellOverlayStyleNew(colors: DiffColorScheme):
 export declare function buildDeletedCellOverlayStyle(colors: DiffColorScheme): string;
 /** Cell overlay for deleted table cells — rounded variant (zIndex 2, inherits border/radius). */
 export declare function buildDeletedCellOverlayRoundedStyle(colors: DiffColorScheme): string;
+/**
+ * Inserted inline content under the extended diff experience. `insertedInlineTreatment` picks
+ * `text-decoration` vs a `border-bottom` rule; only the latter honours `hideAddedDiffsUnderline`.
+ */
+export declare function buildInsertedInlineStyle(colors: DiffColorScheme, isActive: boolean, hideAddedDiffsUnderline: boolean): string;
+/** The three visual states deleted inline content can be in. */
+export type DeletedInlineState = 'active' | 'default' | 'new';
+/**
+ * Deleted inline content in a given state. 'strikethrough' renders 'default' and 'new'
+ * identically; the 'new' step exists only for the 'glyphTint' opacity ramp.
+ */
+export declare function buildDeletedInlineContentStyle(colors: DiffColorScheme, state: DeletedInlineState): string;
+/**
+ * The positioned line across deleted content spanning an unbounded range. 'stateful' thickens
+ * 1px to 2px when active and tints with the border accent; 'static' uses the text accent always.
+ */
+export declare function buildDeletedStrikethroughLine(colors: DiffColorScheme, isActive: boolean): string;
+/**
+ * The "REMOVED" lozenge on a deleted block node — resting state. Neutral gray in every scheme,
+ * so it takes no DiffColorScheme; only the active state is tinted.
+ */
+export declare function buildDeletedLozengeStyle(): string;
+/** The "REMOVED" lozenge — active state, tinted with the scheme's deleteActiveColor. */
+export declare function buildDeletedLozengeActiveStyle(colors: DiffColorScheme): string;
+/** The decoration shape an inserted block node takes. Determined by node type, not by scheme. */
+export type InsertedBlockNodeShape = 'cardBlock' | 'marker' | 'node' | 'quote' | 'rule';
+/**
+ * Outline for an inserted block node. `insertedNodeEmphasis`: 'stateful' draws a 4px ring
+ * (`subtlest` at rest, `subtler.pressed` when focused), 'static' one 1px accent ring.
+ */
+export declare function buildInsertedBlockNodeStyle(colors: DiffColorScheme, shape: InsertedBlockNodeShape, isActive: boolean): string;
+/**
+ * The category a deleted block node falls into — by node type, not by scheme.
+ *
+ * 'container' — media, panel: content is a child element, so the node is only dimmed.
+ * 'listItem'  — listItem: reads the marker variables via editor-core's list styles.
+ * 'marker'    — extension, embedCard: same, via extension and smart-card styles.
+ * 'quote'     — blockquote.
+ * 'generic'   — rule, blockCard, everything else.
+ */
+export type DeletedBlockNodeCategory = 'container' | 'generic' | 'listItem' | 'marker' | 'quote';
+/**
+ * Outline for a deleted block node, driven by `deletedInlineTreatment` (strike vs tint) and
+ * `deletedNodeEmphasis` (whether the outline tracks scroll state and emits marker variables).
+ */
+export declare function buildDeletedBlockNodeStyle(colors: DiffColorScheme, category: DeletedBlockNodeCategory, isActive: boolean): string;
+/**
+ * Deleted blockquote inside a lozenge wrapper (the nodeview path). Always a ring, since the
+ * lozenge needs an enclosed shape, so `deletedQuoteNodeShape` does not apply — only
+ * `deletedQuoteNodeActiveTone`, which picks the active ring's tone.
+ */
+export declare function buildDeletedQuoteNodeWithLozengeStyle(colors: DiffColorScheme, isActive: boolean): string;
+/**
+ * Outline for a deleted block node via the nodeview wrapper (expand, decisionList, panel,
+ * codeBlock). Every scheme shares the active state; `deletedNodeEmphasis` changes only the
+ * resting one — 'stateful' a 4px subtlest ring, 'static' a 1px accent ring.
+ */
+export declare function buildDeletedWrappedBlockOutline(colors: DiffColorScheme, { isActive, isRounded }: {
+    isActive: boolean;
+    isRounded: boolean;
+}): string;
+/**
+ * Accent colour for atomic inline changed nodes (date, emoji, mention, status). Set inline on the
+ * decoration span and read by the `.show-diff-atomic-inline-changed-*` selectors in
+ * EditorContentContainer, on the decorated element or a descendant, so it must inherit. Being
+ * inline it beats the stylesheet's fallback, making the plugin the only source of the colour.
+ */
+export declare function buildAtomicInlineChangedCSSVariables(colors: DiffColorScheme): string;
+/** Deleted node wrapper variables, all three states. Read by the smartCardStyles selectors. */
+export declare function buildDeletedNodeCSSVariables(colors: DiffColorScheme): string;

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

@@ -1,5 +1,8 @@
+import type { ColorScheme } from '../../../showDiffPluginType';
 import type { DiffColorScheme } from './types';
 /** Green insertions, red deletions. */
 export declare const traditionalScheme: DiffColorScheme;
 /** Purple insertions, gray deletions (red on active). */
 export declare const standardScheme: DiffColorScheme;
+/** Maps the public ColorScheme string to its data object. Adding a scheme = one entry here. */
+export declare const colorSchemeRegistry: Record<ColorScheme, DiffColorScheme>;

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

@@ -5,8 +5,8 @@
 export type AdsAccentColor = 'green' | 'teal' | 'blue' | 'purple' | 'red' | 'orange' | 'yellow' | 'magenta' | 'gray';
 /**
  * A show-diff colour scheme. Colour fields are accent names that `factory.ts` expands into token
- * paths; the rest encode structural differences between schemes that no colour can express. Ring
- * widths, padding, radius and pointer-events are fixed in the factory, not per scheme.
+ * paths; the rest encode structural differences no colour can express. Ring widths, padding,
+ * radius and pointer-events are fixed in the factory, not per scheme.
  */
 export type DiffColorScheme = {
     /** Stacking order of the square added-cell overlay. The rounded variant is always 2. */
@@ -21,9 +21,15 @@ export type DiffColorScheme = {
     deletedCellBorderProminence: 'subtle' | 'accent';
     /** Deleted cell overlays. Gray in both current schemes. */
     deletedCellColor: AdsAccentColor;
+    /** Deleted inline content: tint the strikethrough, or tint and dim the glyph itself. */
+    deletedInlineTreatment: 'strikethrough' | 'glyphTint';
+    /** Deleted block ring: 4px stateful ring plus marker variables, or one resting treatment. */
+    deletedNodeEmphasis: 'stateful' | 'static';
+    /** Active deleted-blockquote ring tone, for the nodeview-wrapped case only. */
+    deletedQuoteNodeActiveTone: 'backgroundPressed' | 'borderAccent';
     /** Deleted blockquote default state: 1px ring with padding, or a 2px left border. Active is always a ring. */
     deletedQuoteNodeShape: 'ring' | 'borderLeft';
-    /** Deleted row de-emphasis: colour the strikethrough, or tint the text. Both read `deleteColor`. */
+    /** Deleted row de-emphasis: tint the line-through, or tint the row text. Both read `deleteColor`. */
     deletedRowTreatment: 'strikeColor' | 'textTint';
     /** Inserted content, active/focused state. */
     insertActiveColor: AdsAccentColor;
@@ -31,6 +37,10 @@ export type DiffColorScheme = {
     insertColor: AdsAccentColor;
     /** Opacity of the inserted cell overlay background. */
     insertedCellOpacity: number;
+    /** Inserted content under the extended experience: underline, or a border-bottom rule with padding. */
+    insertedInlineTreatment: 'underline' | 'borderBottom';
+    /** Inserted block ring: 4px stateful ring, or one static 1px accent ring. */
+    insertedNodeEmphasis: 'stateful' | 'static';
     /** `text-decoration-style` for the inserted-text underline. */
     insertUnderlineStyle: 'solid' | 'dotted';
     /** Whether the rounded added-cell overlay inherits the cell's `border`. Deleted always does. */

package/dist/types/pm-plugins/decorations/createBlockChangedDecoration.styles.legacy.d.ts

@@ -0,0 +1,14 @@
+import type { ColorScheme, DiffType } from '../../showDiffPluginType';
+/** Verbatim copy of the pre-refactor cell-overlay style selection. */
+export declare const resolveCellOverlayStyleLegacy: ({ colorScheme, isRoundedTable, useAddedStyle, }: {
+    colorScheme?: ColorScheme;
+    isRoundedTable: boolean;
+    useAddedStyle: boolean;
+}) => string;
+export declare const getBlockNodeStyleLegacy: ({ nodeName, colorScheme, isInserted, isActive, diffType, }: {
+    colorScheme?: ColorScheme;
+    diffType?: DiffType;
+    isActive?: boolean;
+    isInserted?: boolean;
+    nodeName: string;
+}) => string | undefined;

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

@@ -0,0 +1,22 @@
+/**
+ * Pre-refactor code preserved for the OFF cohort of
+ * `platform_editor_show_diff_color_scheme_refactor`.
+ *
+ * These resolvers reproduce the per-scheme string-constant style decisions that
+ * `createChangedRowDOM` made before the `colorSchemeRegistry` + `factory.ts` migration, verbatim.
+ *
+ * Do not modify. Delete this file at experiment cleanup (EDITOR-8281).
+ */
+import type { ColorScheme } from '../../showDiffPluginType';
+/**
+ * Pre-refactor deleted-row style for the `<tr>` element.
+ */
+export declare const resolveDeletedRowStyleLegacy: (colorScheme?: ColorScheme) => string;
+/**
+ * Pre-refactor cell overlay style.
+ */
+export declare const resolveCellOverlayStyleLegacy: ({ colorScheme, isInserted, isRoundedTable, }: {
+    colorScheme?: ColorScheme;
+    isInserted?: boolean;
+    isRoundedTable: boolean;
+}) => string;

package/dist/types/pm-plugins/decorations/createInlineChangedDecoration.styles.legacy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pre-refactor `createInlineChangedDecoration` styling code, preserved verbatim for the OFF cohort
+ * of `platform_editor_show_diff_color_scheme_refactor`.
+ *
+ * Do not modify — this module exists purely so the OFF cohort keeps running the exact code that
+ * shipped before the `colorSchemeRegistry` + `factory.ts` migration. Delete the whole file at
+ * experiment cleanup (EDITOR-8281).
+ */
+import type { ColorScheme, DiffType } from '../../showDiffPluginType';
+import type { InlineAttrChangeNodeName } from './utils/getAttrChangeRanges';
+/**
+ * Pre-refactor inline `style` computation for `createInlineChangedDecoration`.
+ */
+export declare const resolveInlineChangedStyleLegacy: ({ colorScheme, diffType, hideAddedDiffsUnderline, isActive, isInserted, }: {
+    colorScheme: ColorScheme | undefined;
+    diffType: DiffType | undefined;
+    hideAddedDiffsUnderline: boolean;
+    isActive: boolean;
+    isInserted: boolean;
+}) => string;
+/**
+ * Pre-refactor class names for an atomic inline node decoration (date, emoji, mention, status).
+ * The colour was carried by the per-scheme `-traditional` class rather than by an inline CSS
+ * variable on the same element.
+ */
+export declare const getAtomicInlineNodeClassNameLegacy: (inlineNodeName: InlineAttrChangeNodeName | undefined, colorScheme: ColorScheme | undefined) => string;

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

@@ -0,0 +1,39 @@
+import type { ColorScheme, DiffType } from '../../../showDiffPluginType';
+/**
+ * Node-name classification shared by the style resolvers below and by the routing in
+ * `wrapBlockNodeView.ts`.
+ */
+export declare const isMultiContainerBlockNode: (nodeName: string) => boolean;
+export declare const isTextLikeBlockNode: (nodeName: string) => boolean;
+/** Inline content style for a changed (inserted or deleted) block node. */
+export declare const getChangedContentStyle: (colorScheme?: ColorScheme, isActive?: boolean, isInserted?: boolean, diffType?: DiffType, hideAddedDiffsUnderline?: boolean) => string;
+/** Node-specific style for a changed block node, or `undefined` when the node type has none. */
+export declare const getChangedNodeStyle: (nodeName: string, colorScheme?: ColorScheme, isInserted?: boolean, isActive?: boolean, diffType?: DiffType, hideAddedDiffsUnderline?: boolean) => string | undefined;
+/** The positioned line drawn across deleted content spanning an unbounded range. */
+export declare const getDeletedContentStyleUnbounded: (colorScheme?: ColorScheme, isActive?: boolean) => string;
+/** Inline style for inserted content. */
+export declare const getInsertedContentStyle: (colorScheme?: ColorScheme, isActive?: boolean, hideAddedDiffsUnderline?: boolean) => string;
+/** Inline style for deleted content. */
+export declare const getDeletedContentStyle: (colorScheme?: ColorScheme, isActive?: boolean, diffType?: DiffType) => string;
+/**
+ * Overlay style for one added or deleted table cell. Invariant across the cells of a table, so the
+ * `querySelectorAll('td, th')` loop in `wrapBlockNodeView.ts` resolves it once.
+ */
+export declare const resolveCellOverlayStyle: (args: {
+    colorScheme?: ColorScheme;
+    isInserted: boolean;
+    isRoundedTable: boolean;
+}) => string;
+/** Inner style for the "Removed" lozenge on a deleted block node. */
+export declare const resolveRemovedLozengeStyle: (colorScheme: ColorScheme | undefined, isActive: boolean) => string;
+/**
+ * Style for inserted content nested inside a multi-container or list node — the `decisionList` and
+ * `taskList` `li`s and the `layoutSection` columns. Scheme-independent: see
+ * `nestedContentScheme` above.
+ */
+export declare const resolveNestedInsertedNodeStyle: () => string;
+/**
+ * Whether the colour scheme draws a resting (non-active) ring on a deleted media/embed node, which
+ * is what the `show-diff-deleted-outline-new` class styles in editor-core's smartCardStyles.
+ */
+export declare const hasRestingDeletedRing: (colorScheme?: ColorScheme) => boolean;

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

@@ -0,0 +1,40 @@
+import type { ColorScheme, DiffType } from '../../../showDiffPluginType';
+/** Pre-refactor inline content style for a changed (inserted or deleted) block node. */
+export declare const getChangedContentStyleLegacy: (colorScheme?: ColorScheme, isActive?: boolean, isInserted?: boolean, diffType?: DiffType, hideAddedDiffsUnderline?: boolean) => string;
+/** Pre-refactor node-specific style for a changed block node. */
+export declare const getChangedNodeStyleLegacy: (nodeName: string, colorScheme?: ColorScheme, isInserted?: boolean, isActive?: boolean, diffType?: DiffType, hideAddedDiffsUnderline?: boolean) => string | undefined;
+/** Pre-refactor unbounded strikethrough line for deleted content. */
+export declare const getDeletedContentStyleUnboundedLegacy: (colorScheme?: ColorScheme, isActive?: boolean) => string;
+/** Pre-refactor inline style for inserted content. */
+export declare const getInsertedContentStyleLegacy: (colorScheme?: ColorScheme, isActive?: boolean, hideAddedDiffsUnderline?: boolean) => string;
+/** Pre-refactor inline style for deleted content. */
+export declare const getDeletedContentStyleLegacy: (colorScheme?: ColorScheme, isActive?: boolean, diffType?: DiffType) => string;
+/**
+ * Pre-refactor table-cell overlay style, as chosen inside the `querySelectorAll('td, th')` loop of
+ * `applyCellOverlayStyles`. The choice does not vary per cell, so hoisting it out of the loop is
+ * behaviour-preserving.
+ *
+ * NOTE: not interchangeable with the same-named resolver in
+ * `createChangedRowDecorationWidgets.styles.legacy.ts`. The two pre-refactor call sites disagreed
+ * for the traditional non-rounded added cell — the nodeview path (here) used
+ * `traditionalAddedCellOverlayStyleNew`, the row-widget path used `traditionalAddedCellOverlayStyle`.
+ * Preserved as-is.
+ */
+export declare const resolveCellOverlayStyleLegacy: ({ colorScheme, isInserted, isRoundedTable, }: {
+    colorScheme?: ColorScheme;
+    isInserted: boolean;
+    isRoundedTable: boolean;
+}) => string;
+/** Pre-refactor inner style for the "Removed" lozenge on a deleted block node. */
+export declare const resolveRemovedLozengeStyleLegacy: (colorScheme: ColorScheme | undefined, isActive: boolean) => string;
+/**
+ * Pre-refactor style for inserted content nested inside a multi-container or list node (the
+ * `decisionList` / `layoutSection` / `taskList` children). Always the standard scheme's node
+ * outline, in every colour scheme.
+ */
+export declare const resolveNestedInsertedNodeStyleLegacy: () => string;
+/**
+ * Pre-refactor scheme predicate behind `maybeAddDeletedOutlineNewClass`. The `!isActive` half of
+ * the original condition stays at the call site in `wrapBlockNodeView.ts`.
+ */
+export declare const hasRestingDeletedRingLegacy: (colorScheme?: ColorScheme) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-show-diff",
-	"version": "13.0.10",
+	"version": "13.1.0",
 	"description": "ShowDiff plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -26,8 +26,9 @@
 		"@atlaskit/editor-plugin-user-intent": "^13.0.0",
 		"@atlaskit/editor-prosemirror": "^8.0.0",
 		"@atlaskit/editor-tables": "^3.0.0",
+		"@atlaskit/platform-feature-experiments": "^0.3.0",
 		"@atlaskit/platform-feature-flags": "^2.1.0",
-		"@atlaskit/tmp-editor-statsig": "^150.0.0",
+		"@atlaskit/tmp-editor-statsig": "^152.0.0",
 		"@atlaskit/tokens": "^16.7.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^1.0.2",