@elliemae/ds-floating-context 3.70.0-next.54 → 3.70.0-next.59

package/dist/esm/utils/floatingPositioning.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/utils/floatingPositioning.ts"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type { DSHookFloatingContextT } from '../react-desc-prop-types.js';\n\ntype RectLike = { top: number; left: number; right: number; bottom: number };\ntype OverflowOffsets = { top: number; bottom: number; left: number; right: number };\n\nconst findFixedParent = (el: Element | null) => {\n  let element = el;\n  while (element && element !== document.body) {\n    const style = getComputedStyle(element);\n    // IMPORTANT: only treat FIXED as special. Absolute parents are common and scroll,\n    // and using their rect as an offset breaks positioning on scroll.\n    if (style.position === 'fixed') {\n      return element;\n    }\n    element = element.parentElement;\n  }\n  return null;\n};\n\nconst adjustForFixedParent = (child: Element) => {\n  const fixedParent = findFixedParent(child);\n  if (fixedParent) {\n    const rect = fixedParent.getBoundingClientRect();\n    return { top: rect.top, left: rect.left };\n  }\n  return { top: 0, left: 0 };\n};\n\n/**\n * Finds nearest ancestor that can CLIP the floating element.\n * This is typically the correct boundary when rendering without portal.\n */\nconst getClippingParent = (el: Element | null): Element | null => {\n  let node = el?.parentElement ?? null;\n\n  while (node && node !== document.body) {\n    const style = getComputedStyle(node);\n\n    const overflowX = style.overflowX || style.overflow;\n    const overflowY = style.overflowY || style.overflow;\n\n    const clipsX = /(auto|scroll|hidden|clip)/.test(overflowX);\n    const clipsY = /(auto|scroll|hidden|clip)/.test(overflowY);\n\n    if (clipsX || clipsY) return node;\n\n    node = node.parentElement;\n  }\n\n  return null;\n};\n\nconst getViewportRect = (): RectLike => ({\n  top: 0,\n  left: 0,\n  right: window.innerWidth,\n  bottom: window.innerHeight,\n});\n\n/**\n * Shift behavior: if any overflow side is positive, push the popper back inside.\n * Similar to Floating UI \"shift\" middleware.\n */\nconst applyShift = (x: number, y: number, overflow: OverflowOffsets) => {\n  let nextX = x;\n  let nextY = y;\n\n  if (overflow.left > 0) nextX += overflow.left;\n  if (overflow.right > 0) nextX -= overflow.right;\n\n  if (overflow.top > 0) nextY += overflow.top;\n  if (overflow.bottom > 0) nextY -= overflow.bottom;\n\n  return { x: nextX, y: nextY };\n};\n\nconst fits = (o: OverflowOffsets) => o.top <= 0 && o.bottom <= 0 && o.left <= 0 && o.right <= 0;\n\nconst getOverflowScore = (o: OverflowOffsets) => {\n  const top = Math.max(0, o.top);\n  const bottom = Math.max(0, o.bottom);\n  const left = Math.max(0, o.left);\n  const right = Math.max(0, o.right);\n\n  const total = top + bottom + left + right;\n  const maxSide = Math.max(top, bottom, left, right);\n\n  return { total, maxSide };\n};\n\n/**\n * Ensure we actually TRY variations (start/end) for each base placement.\n * Fixes cases where only e.g. \"bottom-end\" fits but would never be tried.\n */\nconst expandWithVariations = (pls: DSHookFloatingContextT.PopperPlacementsT[]) => {\n  const out: DSHookFloatingContextT.PopperPlacementsT[] = [];\n  const seen = new Set<string>();\n\n  const add = (p: string) => {\n    if (!seen.has(p)) {\n      seen.add(p);\n      out.push(p as DSHookFloatingContextT.PopperPlacementsT);\n    }\n  };\n\n  pls.forEach((p) => {\n    add(p);\n\n    const [base, variation] = p.split('-');\n    if (!variation) {\n      add(`${base}-start`);\n      add(`${base}-end`);\n    }\n  });\n\n  return out;\n};\n\n/**\n * When rendering WITHOUT portal, the floating element is positioned relative to its offsetParent.\n * But referenceRect/floatingRect are in viewport coordinates, so we must convert x/y from viewport\n * space into the offsetParent's coordinate space (including its scroll offsets).\n */\nconst getOffsetParentData = (floating: HTMLElement) => {\n  const op = floating.offsetParent as HTMLElement | null;\n\n  // If there's no offsetParent (rare), assume viewport.\n  if (!op) {\n    return { left: 0, top: 0, scrollLeft: 0, scrollTop: 0 };\n  }\n\n  const opRect = op.getBoundingClientRect();\n\n  return {\n    left: opRect.left,\n    top: opRect.top,\n    scrollLeft: op.scrollLeft ?? 0,\n    scrollTop: op.scrollTop ?? 0,\n  };\n};\n\nexport {\n  applyShift,\n  adjustForFixedParent,\n  expandWithVariations,\n  fits,\n  getClippingParent,\n  getOverflowScore,\n  getOffsetParentData,\n  getViewportRect,\n  type RectLike,\n  type OverflowOffsets,\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import type { DSHookFloatingContextT } from '../react-desc-prop-types.js';\n\ntype RectLike = { top: number; left: number; right: number; bottom: number };\ntype OverflowOffsets = { top: number; bottom: number; left: number; right: number };\n\nconst findFixedParent = (el: Element | null) => {\n  let element = el;\n  while (element && element !== document.body) {\n    const style = getComputedStyle(element);\n    // IMPORTANT: only treat FIXED as special. Absolute parents are common and scroll,\n    // and using their rect as an offset breaks positioning on scroll.\n    if (style.position === 'fixed') {\n      return element;\n    }\n    element = element.parentElement;\n  }\n  return null;\n};\n\nconst adjustForFixedParent = (child: Element) => {\n  const fixedParent = findFixedParent(child);\n  if (fixedParent) {\n    const rect = fixedParent.getBoundingClientRect();\n    return { top: rect.top, left: rect.left };\n  }\n  return { top: 0, left: 0 };\n};\n\n/**\n * Finds nearest ancestor that can CLIP the floating element.\n * This is typically the correct boundary when rendering without portal.\n */\nconst getClippingParent = (el: Element | null): Element | null => {\n  let node = el?.parentElement ?? null;\n\n  while (node && node !== document.body) {\n    const style = getComputedStyle(node);\n\n    const overflowX = style.overflowX || style.overflow;\n    const overflowY = style.overflowY || style.overflow;\n\n    const clipsX = /(auto|scroll|hidden|clip)/.test(overflowX);\n    const clipsY = /(auto|scroll|hidden|clip)/.test(overflowY);\n\n    if (clipsX || clipsY) return node;\n\n    node = node.parentElement;\n  }\n\n  return null;\n};\n\nconst getViewportRect = (): RectLike => ({\n  top: 0,\n  left: 0,\n  right: window.innerWidth,\n  bottom: window.innerHeight,\n});\n\n/**\n * Intersects the viewport with an explicit boundary (e.g. a scrollable ancestor the consumer\n * wants the floating element visually contained within), one axis at a time. An axis is only\n * constrained to the boundary when the floating element's own size actually fits within it \u2014\n * otherwise that axis falls back to the plain viewport. Without this fallback, content larger\n * than the boundary (e.g. a full calendar inside a short table row) gets forced into an\n * impossible position instead of being allowed to escape it, as it does today.\n */\nconst getBoundaryConstrainedRect = (\n  viewportRect: RectLike,\n  boundaryRect: RectLike,\n  floatingSize: { width: number; height: number },\n): RectLike => {\n  const fitsWidth = floatingSize.width <= boundaryRect.right - boundaryRect.left;\n  const fitsHeight = floatingSize.height <= boundaryRect.bottom - boundaryRect.top;\n\n  return {\n    top: fitsHeight ? Math.max(viewportRect.top, boundaryRect.top) : viewportRect.top,\n    bottom: fitsHeight ? Math.min(viewportRect.bottom, boundaryRect.bottom) : viewportRect.bottom,\n    left: fitsWidth ? Math.max(viewportRect.left, boundaryRect.left) : viewportRect.left,\n    right: fitsWidth ? Math.min(viewportRect.right, boundaryRect.right) : viewportRect.right,\n  };\n};\n\n/**\n * Shift behavior: if any overflow side is positive, push the popper back inside.\n * Similar to Floating UI \"shift\" middleware.\n */\nconst applyShift = (x: number, y: number, overflow: OverflowOffsets) => {\n  let nextX = x;\n  let nextY = y;\n\n  if (overflow.left > 0) nextX += overflow.left;\n  if (overflow.right > 0) nextX -= overflow.right;\n\n  if (overflow.top > 0) nextY += overflow.top;\n  if (overflow.bottom > 0) nextY -= overflow.bottom;\n\n  return { x: nextX, y: nextY };\n};\n\nconst fits = (o: OverflowOffsets) => o.top <= 0 && o.bottom <= 0 && o.left <= 0 && o.right <= 0;\n\nconst getOverflowScore = (o: OverflowOffsets) => {\n  const top = Math.max(0, o.top);\n  const bottom = Math.max(0, o.bottom);\n  const left = Math.max(0, o.left);\n  const right = Math.max(0, o.right);\n\n  const total = top + bottom + left + right;\n  const maxSide = Math.max(top, bottom, left, right);\n\n  return { total, maxSide };\n};\n\n/**\n * Ensure we actually TRY variations (start/end) for each base placement.\n * Fixes cases where only e.g. \"bottom-end\" fits but would never be tried.\n */\nconst expandWithVariations = (pls: DSHookFloatingContextT.PopperPlacementsT[]) => {\n  const out: DSHookFloatingContextT.PopperPlacementsT[] = [];\n  const seen = new Set<string>();\n\n  const add = (p: string) => {\n    if (!seen.has(p)) {\n      seen.add(p);\n      out.push(p as DSHookFloatingContextT.PopperPlacementsT);\n    }\n  };\n\n  pls.forEach((p) => {\n    add(p);\n\n    const [base, variation] = p.split('-');\n    if (!variation) {\n      add(`${base}-start`);\n      add(`${base}-end`);\n    }\n  });\n\n  return out;\n};\n\n/**\n * When rendering WITHOUT portal, the floating element is positioned relative to its offsetParent.\n * But referenceRect/floatingRect are in viewport coordinates, so we must convert x/y from viewport\n * space into the offsetParent's coordinate space (including its scroll offsets).\n */\nconst getOffsetParentData = (floating: HTMLElement) => {\n  const op = floating.offsetParent as HTMLElement | null;\n\n  // If there's no offsetParent (rare), assume viewport.\n  if (!op) {\n    return { left: 0, top: 0, scrollLeft: 0, scrollTop: 0 };\n  }\n\n  const opRect = op.getBoundingClientRect();\n\n  return {\n    left: opRect.left,\n    top: opRect.top,\n    scrollLeft: op.scrollLeft ?? 0,\n    scrollTop: op.scrollTop ?? 0,\n  };\n};\n\nexport {\n  applyShift,\n  adjustForFixedParent,\n  expandWithVariations,\n  fits,\n  getBoundaryConstrainedRect,\n  getClippingParent,\n  getOverflowScore,\n  getOffsetParentData,\n  getViewportRect,\n  type RectLike,\n  type OverflowOffsets,\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/hooks/useReferenceHiddenByBoundary.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tracks whether `reference` is currently visible at all within `boundaryElement` — e.g. a
+ * scrollable ancestor the reference lives inside. Returns true the moment the reference scrolls
+ * fully out of that boundary's visible area (intersection ratio 0), even though it may still be
+ * within the browser viewport; flips back to false as soon as it's visible again. This is what
+ * boundaryElement/clamping cannot solve on its own: a clamped floating element just sticks at
+ * the boundary's edge, orphaned, once its reference is no longer visible to anchor it to — the
+ * consumer still considers it "open," it should just not be shown while its anchor isn't there.
+ *
+ * Always false (inert) when boundaryElement is not provided — this is opt-in, paired with
+ * useFloatingContext's boundaryElement prop.
+ */
+export declare const useReferenceHiddenByBoundary: ({ reference, boundaryElement, enabled, }: {
+    reference: Element | null;
+    boundaryElement?: Element | null;
+    enabled: boolean;
+}) => boolean;

package/dist/types/react-desc-prop-types.d.ts

@@ -55,6 +55,26 @@ export declare namespace DSHookFloatingContextT {
          * removes the visibility:hidden race that breaks programmatic focus on open.
          */
         externalReferenceElement?: Element | null;
+        /**
+         * Opt-in extra boundary — e.g. a scrollable ancestor of the reference — the floating
+         * element should stay visually contained within, in addition to the viewport. Only
+         * applied when portaled (withoutPortal: false, the default).
+         *
+         * Not the same as `withoutPortal: true`, and not a substitute for it: withoutPortal already
+         * derives a clipping ancestor automatically, but does so by rendering the floating element
+         * as a literal DOM descendant of it — so the browser's own CSS overflow clipping applies
+         * unconditionally, cutting off any floating content taller/wider than that ancestor, with no
+         * way for position math to prevent it. boundaryElement keeps the portal, so oversized
+         * content (e.g. a full calendar popover inside a short container) still escapes fully into
+         * the page, unclipped — it only changes the clipping *math* used for shift/flip, ignored
+         * per-axis when the floating content doesn't fit that axis of the boundary, falling back to
+         * the plain viewport for that axis instead of forcing an impossible position.
+         *
+         * Also hides the floating element (opacity/pointer-events only — isOpen state is untouched)
+         * whenever the reference scrolls fully out of this boundary's visible area, and shows it
+         * again automatically once the reference is back in view.
+         */
+        boundaryElement?: Element | null;
         /**
          * Called when the user clicks/taps outside both the floating element and
          * the reference element while the floating is open.

package/dist/types/useComputedPositionStyles.d.ts

@@ -10,6 +10,9 @@ type UseComputedPositionStylesT = {
     placementOrderPreference?: DSHookFloatingContextT.PopperPlacementsT[];
     customOffset: [number, number];
     withoutPortal: boolean;
+    /** Opt-in extra boundary the floating element should stay visually contained within, in
+     * addition to the viewport, when portaled. See computePosition's boundaryElement doc. */
+    boundaryElement?: Element | null;
     /** Debounce ms for scroll/resize/observer events */
     debounceMs?: number;
 };

package/dist/types/utils/computePosition.d.ts

@@ -6,6 +6,29 @@ interface ComputePositionProps {
     placementOrderPreference?: DSHookFloatingContextT.PopperPlacementsT[];
     customOffset: [number, number];
     withoutPortal: boolean;
+    /**
+     * Opt-in extra boundary (e.g. a scrollable ancestor of the reference) the floating element
+     * should stay visually contained within, in addition to the viewport. Only applied when
+     * portaled — the non-portal path already derives its own clipping ancestor automatically via
+     * getClippingParent, by walking up from the reference.
+     *
+     * Why this exists instead of just setting `withoutPortal: true` to get that same automatic
+     * clipping-ancestor derivation: withoutPortal renders the floating element as a literal DOM
+     * descendant of the clipping ancestor, so the browser's own CSS overflow clipping applies
+     * unconditionally — any floating content taller/wider than that ancestor gets visually cut
+     * off, with no way for position math to prevent it. That is fine for content that always fits
+     * (e.g. a small filter's low/high inputs), but breaks content that can legitimately be larger
+     * than its reference's scroll container (e.g. a date-range calendar popover inside a short
+     * table row) — see PUI-17187 in ds-data-table's FilterPopover for the exact regression this
+     * caused when withoutPortal was tried first.
+     *
+     * boundaryElement keeps the portal (so oversized content still escapes fully into the page,
+     * unclipped, exactly like the no-boundaryElement case) and only changes the clipping *rect*
+     * used for shift/flip math — ignored per-axis when the floating content doesn't fit that axis
+     * of the boundary (see getBoundaryConstrainedRect), falling back to the plain viewport for
+     * that axis so oversized content is never forced into an impossible position.
+     */
+    boundaryElement?: Element | null;
 }
 export declare const computePosition: (props: ComputePositionProps) => {
     coordsStyle: {

package/dist/types/utils/floatingPositioning.d.ts

@@ -21,6 +21,18 @@ declare const adjustForFixedParent: (child: Element) => {
  */
 declare const getClippingParent: (el: Element | null) => Element | null;
 declare const getViewportRect: () => RectLike;
+/**
+ * Intersects the viewport with an explicit boundary (e.g. a scrollable ancestor the consumer
+ * wants the floating element visually contained within), one axis at a time. An axis is only
+ * constrained to the boundary when the floating element's own size actually fits within it —
+ * otherwise that axis falls back to the plain viewport. Without this fallback, content larger
+ * than the boundary (e.g. a full calendar inside a short table row) gets forced into an
+ * impossible position instead of being allowed to escape it, as it does today.
+ */
+declare const getBoundaryConstrainedRect: (viewportRect: RectLike, boundaryRect: RectLike, floatingSize: {
+    width: number;
+    height: number;
+}) => RectLike;
 /**
  * Shift behavior: if any overflow side is positive, push the popper back inside.
  * Similar to Floating UI "shift" middleware.
@@ -50,4 +62,4 @@ declare const getOffsetParentData: (floating: HTMLElement) => {
     scrollLeft: number;
     scrollTop: number;
 };
-export { applyShift, adjustForFixedParent, expandWithVariations, fits, getClippingParent, getOverflowScore, getOffsetParentData, getViewportRect, type RectLike, type OverflowOffsets, };
+export { applyShift, adjustForFixedParent, expandWithVariations, fits, getBoundaryConstrainedRect, getClippingParent, getOverflowScore, getOffsetParentData, getViewportRect, type RectLike, type OverflowOffsets, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-floating-context",
-  "version": "3.70.0-next.54",
+  "version": "3.70.0-next.59",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Popper Hook",
   "files": [
@@ -36,20 +36,20 @@
     "indent": 4
   },
   "dependencies": {
-    "@elliemae/ds-hooks-headless-tooltip": "3.70.0-next.54",
-    "@elliemae/ds-props-helpers": "3.70.0-next.54",
-    "@elliemae/ds-typescript-helpers": "3.70.0-next.54",
-    "@elliemae/ds-system": "3.70.0-next.54"
+    "@elliemae/ds-hooks-headless-tooltip": "3.70.0-next.59",
+    "@elliemae/ds-props-helpers": "3.70.0-next.59",
+    "@elliemae/ds-typescript-helpers": "3.70.0-next.59",
+    "@elliemae/ds-system": "3.70.0-next.59"
   },
   "devDependencies": {
     "jest": "^30.0.0",
-    "@elliemae/ds-monorepo-devops": "3.70.0-next.54"
+    "@elliemae/ds-monorepo-devops": "3.70.0-next.59"
   },
   "peerDependencies": {
     "lodash-es": "^4.18.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "styled-components": "~5.3.9",
+    "styled-components": "~5.3.11",
     "styled-system": "^5.1.5"
   },
   "publishConfig": {
@@ -65,4 +65,4 @@
     "build": "cross-env NODE_ENV=production node ../../../scripts/build/build.mjs",
     "checkDeps": "npx -yes ../../util/ds-codemods check-missing-packages --projectFolderPath=\"./\" --ignorePackagesGlobPattern=\"\" --ignoreFilesGlobPattern=\"**/test-ables/*,**/tests/*\""
   }
-}
+}