@atlaskit/popup 4.17.0 → 4.19.0

package/dist/types-ts4.5/types.d.ts

@@ -139,6 +139,11 @@ interface BaseProps {
      * The distance the popup should be offset from the reference in the format of [along, away] (units in px).
      * The default is `[0, 8]`, which means the popup will be `8px` away from the edge of the reference specified
      * by the `placement` prop.
+     *
+     * @private
+     * Note: when `platform-dst-top-layer` is enabled, both the `along` and `away`
+     * values are passed through to the top-layer placement (via `fromLegacyPlacement`),
+     * matching the legacy popper-js behaviour.
      */
     offset?: [
         number,
@@ -154,22 +159,38 @@ interface BaseProps {
      * When the preferred placement doesn't have enough space,
      * the modifier will test the ones provided in the list, and use the first suitable one.
      * If no fallback placements are suitable, it reverts back to the original placement.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * generates fallbacks automatically via `position-try-fallbacks`.
      */
     fallbackPlacements?: Placement[];
     /**
      * The boundary element that the popup will check for overflow.
      * The default is `"clippingParents"` which are parent scroll containers,
      * but can be set to any element.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the viewport
+     * is the natural boundary for top-layer elements.
      */
     boundary?: 'clippingParents' | HTMLElement;
     /**
      * The root boundary that the popup will check for overflow.
      * The default is `"viewport"` but it can be set to `"document"`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the viewport
+     * is the natural boundary for top-layer elements.
      */
     rootBoundary?: 'viewport' | 'document';
     /**
      * Allows the popup to be placed on the opposite side of its trigger if it doesn't fit in the viewport.
      * The default is `true`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * handles flipping natively via `position-try-fallbacks`.
      */
     shouldFlip?: boolean;
     /**
@@ -213,6 +234,10 @@ interface BaseProps {
     /**
      * The root element where the popup should be rendered.
      * Defaults to `false`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — content always
+     * renders in the browser's top layer.
      */
     shouldRenderToParent?: boolean;
     /**
@@ -225,6 +250,10 @@ interface BaseProps {
     /**
      * This makes the popup close on Tab key press. It will only work when `shouldRenderToParent` is `true`.
      * The default is `false`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — focus trapping
+     * is role-based in the top-layer path.
      */
     shouldDisableFocusLock?: boolean;
     /**
@@ -235,6 +264,10 @@ interface BaseProps {
     /**
      * This controls the positioning strategy to use. Can vary between `absolute` and `fixed`.
      * The default is `fixed`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * replaces Popper's positioning strategy.
      */
     strategy?: 'absolute' | 'fixed';
     /**
@@ -275,6 +308,10 @@ interface InternalPopupProps extends BaseProps {
      * Z-index that the popup should be displayed in.
      * This is passed to the portal component.
      * The default is 400.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the browser's
+     * top layer manages stacking without z-index.
      */
     zIndex?: number;
 }
@@ -288,6 +325,7 @@ type ShouldFitContainerPopupProps = InternalPopupProps & {
 };
 export type PopupProps = StandardPopupProps | ShouldFitContainerPopupProps;
 export interface PopperWrapperProps extends BaseProps {
+    zIndex?: number;
     triggerRef: TriggerRef;
 }
 export type CloseManagerHook = Pick<PopupProps, 'isOpen' | 'onClose'> & {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/popup",
-	"version": "4.17.0",
+	"version": "4.19.0",
 	"description": "A popup displays brief content in an overlay.",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -42,12 +42,13 @@
 		"@atlaskit/css": "^0.19.0",
 		"@atlaskit/ds-lib": "^7.0.0",
 		"@atlaskit/layering": "^3.7.0",
-		"@atlaskit/motion": "^6.0.0",
+		"@atlaskit/motion": "^6.2.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/popper": "^7.2.0",
-		"@atlaskit/portal": "^5.4.0",
+		"@atlaskit/portal": "^5.5.0",
 		"@atlaskit/primitives": "^19.0.0",
 		"@atlaskit/tokens": "^13.0.0",
+		"@atlaskit/top-layer": "^0.6.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
 		"bind-event-listener": "^3.0.0",
@@ -64,20 +65,21 @@
 		"@af/integration-testing": "workspace:^",
 		"@af/visual-regression": "workspace:^",
 		"@atlaskit/button": "^23.11.0",
-		"@atlaskit/code": "^17.4.0",
+		"@atlaskit/code": "^17.5.0",
 		"@atlaskit/docs": "^11.8.0",
 		"@atlaskit/form": "^15.5.0",
 		"@atlaskit/heading": "^5.4.0",
-		"@atlaskit/icon": "^34.3.0",
+		"@atlaskit/icon": "^34.5.0",
 		"@atlaskit/link": "^3.4.0",
-		"@atlaskit/modal-dialog": "^14.18.0",
+		"@atlaskit/modal-dialog": "^15.0.0",
 		"@atlaskit/section-message": "^8.12.0",
 		"@atlaskit/textfield": "^8.3.0",
 		"@atlaskit/toggle": "^15.6.0",
-		"@atlassian/feature-flags-test-utils": "^1.0.0",
+		"@atlassian/feature-flags-test-utils": "^1.1.0",
 		"@atlassian/react-compiler-gating": "workspace:^",
 		"@atlassian/ssr-tests": "workspace:^",
 		"@atlassian/structured-docs-types": "workspace:^",
+		"@atlassian/testing-library": "^0.5.0",
 		"@testing-library/react": "^16.3.0",
 		"@testing-library/user-event": "^14.4.3",
 		"ast-types": "^0.13.3",
@@ -111,6 +113,9 @@
 		}
 	},
 	"platform-feature-flags": {
+		"platform-dst-top-layer": {
+			"type": "boolean"
+		},
 		"platform_dst_popup-disable-focuslock": {
 			"type": "boolean"
 		},
@@ -132,7 +137,7 @@
 		"platform_dst_nested_escape": {
 			"type": "boolean"
 		},
-		"platform-dst-motion-uplift": {
+		"platform-dst-motion-uplift-popup": {
 			"type": "boolean"
 		}
 	},

package/offerings.json

@@ -1,34 +0,0 @@
-[
-	{
-		"name": "Popup",
-		"package": "@atlaskit/popup",
-		"import": {
-			"name": "Popup",
-			"package": "@atlaskit/popup",
-			"type": "default"
-		},
-		"keywords": ["popup", "overlay", "floating", "content", "trigger"],
-		"categories": ["overlay"],
-		"shortDescription": "A component for displaying popup content relative to a trigger element.",
-		"status": "general-availability",
-		"accessibilityGuidelines": [
-			"Provide appropriate focus management",
-			"Use clear trigger labels",
-			"Ensure keyboard navigation support",
-			"Provide escape key dismissal"
-		],
-		"usageGuidelines": [
-			"Use for contextual content that appears on demand",
-			"Position appropriately relative to trigger",
-			"Consider dismissal behavior",
-			"Use appropriate content sizing"
-		],
-		"contentGuidelines": [
-			"Keep popup content focused and relevant",
-			"Use clear, concise content",
-			"Provide appropriate actions when needed",
-			"Consider content hierarchy"
-		],
-		"examples": ["./examples/ai/popup.tsx"]
-	}
-]