@atlaskit/editor-plugin-block-controls 20.1.2 → 20.1.4

package/dist/esm/ui/visibility-container.js

@@ -46,13 +46,16 @@ var hiddenStylesCSS = css({
 var displayContentsStylesCSS = css({
   display: 'contents'
 });
-export var VisibilityContainer = function VisibilityContainer(_ref) {
+
+/**
+ * Resolves visibility once so a surface can apply the same state to each rendered control without
+ * creating a plugin-state subscription and hide-delay timer for every control wrapper.
+ */
+export var useBlockControlsVisibility = function useBlockControlsVisibility(_ref) {
   var api = _ref.api,
-    children = _ref.children,
     controlSide = _ref.controlSide,
     forceVisibleOnMouseOut = _ref.forceVisibleOnMouseOut,
-    isPersistent = _ref.isPersistent,
-    shouldUseDisplayContents = _ref.shouldUseDisplayContents;
+    isPersistent = _ref.isPersistent;
   var _useSharedPluginState = useSharedPluginStateWithSelector(api, ['typeAhead', 'blockControls', 'editorViewMode', 'userIntent', 'showDiff'], function (states) {
       var _states$typeAheadStat, _states$blockControls, _states$blockControls2, _states$blockControls3, _states$editorViewMod, _states$userIntentSta, _states$showDiffState, _states$blockControls4;
       return {
@@ -128,9 +131,20 @@ export var VisibilityContainer = function VisibilityContainer(_ref) {
     };
   }, [shouldHideImmediate, isRightControlViewMode]);
   var shouldHide = isRightControlViewMode ? delayedShouldHide : shouldHideImmediate;
-  if (editorExperiment('platform_editor_preview_panel_responsiveness', true, {
+  var useCssStyles = editorExperiment('platform_editor_preview_panel_responsiveness', true, {
     exposure: true
-  })) {
+  });
+  return {
+    shouldHide: shouldHide,
+    useCssStyles: useCssStyles
+  };
+};
+export var VisibilityWrapper = function VisibilityWrapper(_ref2) {
+  var children = _ref2.children,
+    shouldHide = _ref2.shouldHide,
+    shouldUseDisplayContents = _ref2.shouldUseDisplayContents,
+    useCssStyles = _ref2.useCssStyles;
+  if (useCssStyles) {
     return jsx("div", {
       css: [baseStylesCSS, shouldHide ? hiddenStylesCSS : visibleStylesCSS, shouldUseDisplayContents && displayContentsStylesCSS]
     }, children);
@@ -140,4 +154,25 @@ export var VisibilityContainer = function VisibilityContainer(_ref) {
   , {
     xcss: [baseStyles, shouldHide ? hiddenStyles : visibleStyles, shouldUseDisplayContents && displayContentsStyles]
   }, children);
+};
+export var VisibilityContainer = function VisibilityContainer(_ref3) {
+  var api = _ref3.api,
+    children = _ref3.children,
+    controlSide = _ref3.controlSide,
+    forceVisibleOnMouseOut = _ref3.forceVisibleOnMouseOut,
+    isPersistent = _ref3.isPersistent,
+    shouldUseDisplayContents = _ref3.shouldUseDisplayContents;
+  var _useBlockControlsVisi = useBlockControlsVisibility({
+      api: api,
+      controlSide: controlSide,
+      forceVisibleOnMouseOut: forceVisibleOnMouseOut,
+      isPersistent: isPersistent
+    }),
+    shouldHide = _useBlockControlsVisi.shouldHide,
+    useCssStyles = _useBlockControlsVisi.useCssStyles;
+  return jsx(VisibilityWrapper, {
+    shouldHide: shouldHide,
+    shouldUseDisplayContents: shouldUseDisplayContents,
+    useCssStyles: useCssStyles
+  }, children);
 };

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { RegisterComponent, SurfaceContext } from '@atlaskit/editor-ui-control-model/types';
+type BlockControlsVisibility = {
+    shouldHideHoverControls: boolean;
+    useCssStyles: boolean;
+};
+type BlockControlsVisibilityProviderProps = BlockControlsVisibility & {
+    children: React.ReactNode;
+};
+export declare const BlockControlsVisibilityProvider: ({ children, shouldHideHoverControls, useCssStyles, }: BlockControlsVisibilityProviderProps) => React.JSX.Element;
+export declare const getBlockControlsLeftSurfaceComponents: (components: RegisterComponent[], surfaceContext: SurfaceContext) => RegisterComponent[] | undefined;
+export declare const getBlockControlsRightSurfaceComponents: (components: RegisterComponent[], surfaceContext: SurfaceContext) => RegisterComponent[] | undefined;
+export {};

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

@@ -10,6 +10,7 @@ export type SurfacePlacement = {
     left: number;
     top: number;
     transform: string;
+    width?: number;
 };
 export type SurfaceSide = 'left' | 'right';
 export type SurfacePlacementOptions = {
@@ -37,6 +38,13 @@ export declare const getAbsoluteSurfacePlacement: ({ offsetParentRect, offsetPar
  * can be folded straight into `left` with no transform needed.
  */
 export declare const getSurfacePlacement: ({ layout, nodeRect, nodeType, nodeTypeWithLevel, parentNodeType, side, }: SurfacePlacementOptions) => SurfacePlacement;
+export type LeftGutterSurfacePlacementOptions = Omit<SurfacePlacementOptions, 'side'> & {
+    leftGutterBoundary: number;
+};
+/**
+ * Expands a measured left surface from the available gutter boundary to the target node.
+ */
+export declare const getLeftGutterSurfacePlacement: ({ leftGutterBoundary, ...options }: LeftGutterSurfacePlacementOptions) => SurfacePlacement;
 /**
  * The insets to apply to a surface wrapper, plus whether that wrapper spans its target node.
  *
@@ -67,3 +75,8 @@ export type AnchoredSurfacePlacementOptions = {
     side: SurfaceSide;
 };
 export declare const getAnchoredSurfacePlacement: ({ anchorName, layout, nodeType, nodeTypeWithLevel, parentNodeType, side, }: AnchoredSurfacePlacementOptions) => SurfaceWrapperPlacement;
+export type AnchoredLeftGutterSurfacePlacementOptions = Omit<AnchoredSurfacePlacementOptions, 'side'>;
+/**
+ * Expands an anchored left surface across the available gutter without runtime measurement.
+ */
+export declare const getAnchoredLeftGutterSurfacePlacement: (options: AnchoredLeftGutterSurfacePlacementOptions) => SurfaceWrapperPlacement;

package/dist/types/ui/visibility-container.d.ts

@@ -17,5 +17,19 @@ interface VisibilityContainerProps {
      */
     shouldUseDisplayContents?: boolean;
 }
+type VisibilityWrapperProps = Pick<VisibilityContainerProps, 'children' | 'shouldUseDisplayContents'> & {
+    shouldHide: boolean;
+    useCssStyles: boolean;
+};
+type BlockControlsVisibilityOptions = Omit<VisibilityContainerProps, 'children' | 'shouldUseDisplayContents'>;
+/**
+ * Resolves visibility once so a surface can apply the same state to each rendered control without
+ * creating a plugin-state subscription and hide-delay timer for every control wrapper.
+ */
+export declare const useBlockControlsVisibility: ({ api, controlSide, forceVisibleOnMouseOut, isPersistent, }: BlockControlsVisibilityOptions) => {
+    shouldHide: boolean;
+    useCssStyles: boolean;
+};
+export declare const VisibilityWrapper: ({ children, shouldHide, shouldUseDisplayContents, useCssStyles, }: VisibilityWrapperProps) => jsx.JSX.Element;
 export declare const VisibilityContainer: ({ api, children, controlSide, forceVisibleOnMouseOut, isPersistent, shouldUseDisplayContents, }: VisibilityContainerProps) => jsx.JSX.Element;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-plugin-block-controls",
-	"version": "20.1.2",
+	"version": "20.1.4",
 	"description": "Block controls plugin for @atlaskit/editor-core",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -61,7 +61,7 @@
 		"@atlaskit/primitives": "^22.5.0",
 		"@atlaskit/section-message": "^10.2.0",
 		"@atlaskit/theme": "^28.2.0",
-		"@atlaskit/tmp-editor-statsig": "^202.0.0",
+		"@atlaskit/tmp-editor-statsig": "^204.0.0",
 		"@atlaskit/tokens": "^19.0.0",
 		"@atlaskit/tooltip": "^24.3.0",
 		"@babel/runtime": "^7.0.0",
@@ -73,7 +73,7 @@
 		"uuid": "^11.1.1"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^123.7.0",
+		"@atlaskit/editor-common": "^123.8.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"