@atlaskit/editor-plugin-block-controls 17.2.5 → 17.3.0

package/dist/types/ui/block-controls-right-surfaces.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ * @jsxFrag React.Fragment
+ */
+import React from 'react';
+import type { ExtractInjectionAPI } from '@atlaskit/editor-common/types';
+import type { EditorView } from '@atlaskit/editor-prosemirror/view';
+import type { BlockControlsPlugin } from '../blockControlsPluginType';
+type Props = {
+    api: ExtractInjectionAPI<BlockControlsPlugin>;
+    editorView: EditorView;
+};
+/**
+ * Registry-backed right surface tree. Mirrors the left surface's single-tree, measured-placement
+ * approach, but keeps its own components lookup, targets, placements and measurement lifecycle so
+ * the right surface never depends on the left surface's render pass.
+ */
+export declare const BlockControlsRightSurfaces: ({ api, editorView, }: Props) => React.JSX.Element | null;
+export {};

package/dist/types/ui/block-controls-surface-targets.d.ts

@@ -0,0 +1,13 @@
+import type { ActiveNode } from '../blockControlsPluginType';
+export type BlockControlsSurfaceTarget = {
+    position: number;
+    source: 'active' | 'root' | 'stored';
+};
+/**
+ * Combines hover-driven and stored surface positions into one deduplicated list.
+ * Shared by both the left and right surfaces: this is pure position bookkeeping with no
+ * surface-specific behavior, so there's nothing to keep independent between them. What *is*
+ * kept independent is each surface's own React tree (component lookup, measurement effects,
+ * observers) — see block-controls-left-surfaces.tsx / block-controls-right-surfaces.tsx.
+ */
+export declare const getBlockControlsSurfaceTargets: (activeNode: ActiveNode | undefined, storedPositions: readonly number[]) => readonly BlockControlsSurfaceTarget[];

package/dist/types/ui/utils/get-surface-placement.d.ts

@@ -3,12 +3,14 @@ export type SurfacePlacement = {
     top: number;
     transform: string;
 };
+export type SurfaceSide = 'left' | 'right';
 export type SurfacePlacementOptions = {
     layout: string;
-    nodeRect: Pick<DOMRect, 'left' | 'top' | 'width'>;
+    nodeRect: Pick<DOMRect, 'left' | 'right' | 'top' | 'width'>;
     nodeType: string;
     nodeTypeWithLevel: string;
     parentNodeType?: string;
+    side: SurfaceSide;
 };
 export declare const getAbsoluteSurfacePlacement: ({ offsetParentRect, offsetParentScrollLeft, offsetParentScrollTop, placement, }: {
     offsetParentRect?: Pick<DOMRect, 'left' | 'top'>;
@@ -17,7 +19,13 @@ export declare const getAbsoluteSurfacePlacement: ({ offsetParentRect, offsetPar
     placement: SurfacePlacement;
 }) => SurfacePlacement;
 /**
- * Positions the Task 1 left surface beside the legacy drag-handle slot.
- * The surface's own width is handled by the transform, so later controls do not require measuring it.
+ * Positions the surface beside the legacy drag-handle slot, on either the left or right edge
+ * of the target node. Node-type-specific gap/top-adjustment maths (layouts, tables, media, cards,
+ * extensions, etc.) live in one place so left/right edge cases can't drift out of sync.
+ *
+ * The left side grows away from the node without knowing its own width, so it needs
+ * `translateX(-100%)` to anchor its right edge at `nodeRect.left` and extend backward. The right
+ * side grows in the normal box-flow direction (away from the node, into the margin), so the gap
+ * can be folded straight into `left` with no transform needed.
  */
-export declare const getSurfacePlacement: ({ layout, nodeRect, nodeType, nodeTypeWithLevel, parentNodeType, }: SurfacePlacementOptions) => SurfacePlacement;
+export declare const getSurfacePlacement: ({ layout, nodeRect, nodeType, nodeTypeWithLevel, parentNodeType, side, }: SurfacePlacementOptions) => SurfacePlacement;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-block-controls",
-	"version": "17.2.5",
+	"version": "17.3.0",
 	"description": "Block controls plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -21,43 +21,43 @@
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
 		"@atlaskit/browser-apis": "^1.2.0",
-		"@atlaskit/button": "^25.2.0",
+		"@atlaskit/button": "^25.3.0",
 		"@atlaskit/css": "^1.1.0",
 		"@atlaskit/docs": "^12.2.0",
 		"@atlaskit/editor-plugin-accessibility-utils": "^16.0.0",
-		"@atlaskit/editor-plugin-analytics": "^16.0.0",
-		"@atlaskit/editor-plugin-editor-disabled": "^16.0.0",
+		"@atlaskit/editor-plugin-analytics": "^16.1.0",
+		"@atlaskit/editor-plugin-editor-disabled": "^16.1.0",
 		"@atlaskit/editor-plugin-editor-viewmode": "^18.0.0",
-		"@atlaskit/editor-plugin-feature-flags": "^15.0.0",
+		"@atlaskit/editor-plugin-feature-flags": "^15.1.0",
 		"@atlaskit/editor-plugin-interaction": "^27.0.0",
 		"@atlaskit/editor-plugin-limited-mode": "^13.0.0",
 		"@atlaskit/editor-plugin-metrics": "^17.0.0",
-		"@atlaskit/editor-plugin-quick-insert": "^16.1.0",
-		"@atlaskit/editor-plugin-selection": "^16.0.0",
+		"@atlaskit/editor-plugin-quick-insert": "^16.2.0",
+		"@atlaskit/editor-plugin-selection": "^16.1.0",
 		"@atlaskit/editor-plugin-show-diff": "^14.2.0",
 		"@atlaskit/editor-plugin-toolbar": "^13.0.0",
-		"@atlaskit/editor-plugin-type-ahead": "^17.0.0",
+		"@atlaskit/editor-plugin-type-ahead": "^17.1.0",
 		"@atlaskit/editor-plugin-ui-control-registry": "^10.0.0",
 		"@atlaskit/editor-plugin-user-intent": "^14.0.0",
-		"@atlaskit/editor-plugin-width": "^17.0.0",
+		"@atlaskit/editor-plugin-width": "^17.1.0",
 		"@atlaskit/editor-prosemirror": "^8.0.0",
-		"@atlaskit/editor-shared-styles": "^4.0.0",
-		"@atlaskit/editor-tables": "^3.0.0",
+		"@atlaskit/editor-shared-styles": "^4.1.0",
+		"@atlaskit/editor-tables": "^3.1.0",
 		"@atlaskit/editor-ui-control-model": "^2.9.0",
-		"@atlaskit/icon": "^37.5.0",
+		"@atlaskit/icon": "^37.6.0",
 		"@atlaskit/icon-lab": "^7.7.0",
 		"@atlaskit/link": "^5.1.0",
 		"@atlaskit/platform-feature-experiments": "^0.3.0",
-		"@atlaskit/platform-feature-flags": "^2.1.0",
-		"@atlaskit/pragmatic-drag-and-drop": "^3.0.0",
-		"@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^3.1.0",
-		"@atlaskit/pragmatic-drag-and-drop-react-drop-indicator": "^4.1.0",
-		"@atlaskit/primitives": "^22.4.0",
-		"@atlaskit/section-message": "^10.1.0",
-		"@atlaskit/theme": "^28.1.0",
+		"@atlaskit/platform-feature-flags": "^2.2.0",
+		"@atlaskit/pragmatic-drag-and-drop": "^3.1.0",
+		"@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^3.2.0",
+		"@atlaskit/pragmatic-drag-and-drop-react-drop-indicator": "^4.2.0",
+		"@atlaskit/primitives": "^22.5.0",
+		"@atlaskit/section-message": "^10.2.0",
+		"@atlaskit/theme": "^28.2.0",
 		"@atlaskit/tmp-editor-statsig": "^168.0.0",
-		"@atlaskit/tokens": "^16.9.0",
-		"@atlaskit/tooltip": "^24.2.0",
+		"@atlaskit/tokens": "^16.10.0",
+		"@atlaskit/tooltip": "^24.3.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^1.0.2",
 		"@emotion/react": "^11.7.1",
@@ -67,7 +67,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^120.7.0",
+		"@atlaskit/editor-common": "^120.10.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"

package/dist/types/ui/block-controls-left-surface-targets.d.ts

@@ -1,7 +0,0 @@
-import type { ActiveNode } from '../blockControlsPluginType';
-export type BlockControlsLeftSurfaceTarget = {
-    position: number;
-    source: 'active' | 'root' | 'stored';
-};
-/** Combines hover-driven and stored surface positions into one deduplicated list. */
-export declare const getBlockControlsLeftSurfaceTargets: (activeNode: ActiveNode | undefined, storedPositions: readonly number[]) => readonly BlockControlsLeftSurfaceTarget[];